Class TracingDataSource

java.lang.Object
com.amazonaws.xray.sql.TracingDataSource
All Implemented Interfaces:
java.sql.Wrapper, javax.sql.CommonDataSource, javax.sql.DataSource

public class TracingDataSource
extends java.lang.Object
implements javax.sql.DataSource
  • Field Summary

    Fields 
    Modifier and Type Field Description
    protected javax.sql.DataSource delegate  
  • Constructor Summary

    Constructors 
    Constructor Description
    TracingDataSource​(javax.sql.DataSource dataSource)  
  • Method Summary

    Modifier and Type Method Description
    static javax.sql.DataSource decorate​(javax.sql.DataSource dataSource)
    Call dataSource = TracingDataSource.decorate(dataSource) to decorate your DataSource before any calls to #getConnection in order to have all your SQL queries recorded with an X-Ray Subsegment.
    java.sql.Connection getConnection()
    Traced methods
    java.sql.Connection getConnection​(java.lang.String username, java.lang.String password)  
    int getLoginTimeout()  
    java.io.PrintWriter getLogWriter()
    Plain methods
    java.util.logging.Logger getParentLogger()  
    boolean isWrapperFor​(java.lang.Class<?> iface)  
    void setLoginTimeout​(int seconds)  
    void setLogWriter​(java.io.PrintWriter out)  
    <T> T unwrap​(java.lang.Class<T> iface)  

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface javax.sql.CommonDataSource

    createShardingKeyBuilder

    Methods inherited from interface javax.sql.DataSource

    createConnectionBuilder
  • Field Details

    • delegate

      protected javax.sql.DataSource delegate
  • Constructor Details

  • Method Details

    • decorate

      public static javax.sql.DataSource decorate​(javax.sql.DataSource dataSource)
      Call dataSource = TracingDataSource.decorate(dataSource) to decorate your DataSource before any calls to #getConnection in order to have all your SQL queries recorded with an X-Ray Subsegment.
      Parameters:
      dataSource - the datasource to decorate
      Returns:
      a DataSource that traces all SQL queries in X-Ray
    • getConnection

      public java.sql.Connection getConnection() throws java.sql.SQLException
      Traced methods
      Specified by:
      getConnection in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • getConnection

      public java.sql.Connection getConnection​(java.lang.String username, java.lang.String password) throws java.sql.SQLException
      Specified by:
      getConnection in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • unwrap

      public <T> T unwrap​(java.lang.Class<T> iface) throws java.sql.SQLException
      Specified by:
      unwrap in interface java.sql.Wrapper
      Throws:
      java.sql.SQLException
    • isWrapperFor

      public boolean isWrapperFor​(java.lang.Class<?> iface) throws java.sql.SQLException
      Specified by:
      isWrapperFor in interface java.sql.Wrapper
      Throws:
      java.sql.SQLException
    • getLogWriter

      public java.io.PrintWriter getLogWriter() throws java.sql.SQLException
      Plain methods
      Specified by:
      getLogWriter in interface javax.sql.CommonDataSource
      Specified by:
      getLogWriter in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • setLogWriter

      public void setLogWriter​(java.io.PrintWriter out) throws java.sql.SQLException
      Specified by:
      setLogWriter in interface javax.sql.CommonDataSource
      Specified by:
      setLogWriter in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • setLoginTimeout

      public void setLoginTimeout​(int seconds) throws java.sql.SQLException
      Specified by:
      setLoginTimeout in interface javax.sql.CommonDataSource
      Specified by:
      setLoginTimeout in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • getLoginTimeout

      public int getLoginTimeout() throws java.sql.SQLException
      Specified by:
      getLoginTimeout in interface javax.sql.CommonDataSource
      Specified by:
      getLoginTimeout in interface javax.sql.DataSource
      Throws:
      java.sql.SQLException
    • getParentLogger

      public java.util.logging.Logger getParentLogger() throws java.sql.SQLFeatureNotSupportedException
      Specified by:
      getParentLogger in interface javax.sql.CommonDataSource
      Throws:
      java.sql.SQLFeatureNotSupportedException