ConnectionHandle (BoneCP :: Core Library 0.8.0-beta1 API)

java.lang.Object
- com.jolbox.bonecp.ConnectionHandle

All Implemented Interfaces:

AutoCloseable, Connection, Wrapper
```
public class ConnectionHandle
extends Object
implements Connection
```
Connection handle wrapper around a JDBC connection.

Author:

wwadge

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`autoCommitStackTrace` Stack track dump.
`protected boolean`	`detectUnresolvedTransactions` Config setting.
`protected AtomicBoolean`	`inUseInThreadLocalContext` If true, this connection is in use in a thread-local context.
`protected boolean`	`logicallyClosed` If true, we've called close() on this connection.
`protected boolean`	`possiblyBroken` If true, this connection might have failed communicating with the database.
`protected TransactionRecoveryResult`	`recoveryResult` Map of translations + result from last recovery.
`protected boolean`	`statementCachingEnabled` Set to true if we have statement caching enabled.
`protected Thread`	`threadUsingConnection` Keep track of the thread.
`protected boolean`	`txResolved` If true, transaction has been marked as COMMITed or ROLLBACKed.
`protected String`	`url` Connection url.

Fields inherited from interface java.sql.Connection
TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`abort(Executor executor)`
`protected void`	`clearStatementCaches(boolean internalClose)` Clears out the statement handles.
`void`	`clearWarnings()`
`void`	`close()` Release the connection if called.
`void`	`commit()`
`Array`	`createArrayOf(String typeName, Object[] elements)`
`Blob`	`createBlob()`
`Clob`	`createClob()`
`static ConnectionHandle`	`createConnectionHandle(String url, String username, String password, BoneCP pool)` Create a connection Handle.
`NClob`	`createNClob()`
`SQLXML`	`createSQLXML()`
`Statement`	`createStatement()`
`Statement`	`createStatement(int resultSetType, int resultSetConcurrency)`
`Statement`	`createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`Struct`	`createStruct(String typeName, Object[] attributes)`
`protected static ConnectionHandle`	`createTestConnectionHandle(Connection connection, IStatementCache preparedStatementCache, IStatementCache callableStatementCache, BoneCP pool)` Private -- used solely for unit testing.
`boolean`	`getAutoCommit()`
`protected String`	`getAutoCommitStackTrace()` Returns the autoCommitStackTrace field.
`String`	`getCatalog()`
`Properties`	`getClientInfo()`
`String`	`getClientInfo(String name)`
`long`	`getConnectionCreationTime()` Deprecated. please use `getConnectionCreationTimeInMs()` instead.
`long`	`getConnectionCreationTimeInMs()` Returns the connectionCreationTime field.
`ConnectionHook`	`getConnectionHook()` Returns the configured connection hook object.
`long`	`getConnectionLastReset()` Deprecated. Please use `getConnectionLastResetInMs()` instead
`long`	`getConnectionLastResetInMs()`
`long`	`getConnectionLastUsed()` Deprecated. Use `getConnectionLastUsedInMs()` instead.
`long`	`getConnectionLastUsedInMs()`
`Object`	`getDebugHandle()` Returns a debug handle as previously set by an application
`int`	`getHoldability()`
`Connection`	`getInternalConnection()` Returns the internal connection as obtained via the JDBC driver.
`DatabaseMetaData`	`getMetaData()`
`int`	`getNetworkTimeout()`
`ConnectionPartition`	`getOriginatingPartition()` Gets the partition this came from.
`BoneCP`	`getPool()` Returns a handle to the global pool from where this connection was obtained.
`Object`	`getProxyTarget()` This method will be intercepted by the proxy if it is enabled to return the internal target.
`Connection`	`getRawConnection()` Deprecated.
`List<ReplayLog>`	`getReplayLog()` Returns transaction history log
`String`	`getSchema()`
`Thread`	`getThreadUsingConnection()` Returns the thread that is currently utilizing this connection.
`Thread`	`getThreadWatch()` Returns the thread watching over this connection.
`int`	`getTransactionIsolation()`
`Map<String,Class<?>>`	`getTypeMap()`
`String`	`getUrl()` Returns the url field.
`SQLWarning`	`getWarnings()`
`protected void`	`internalClose()` Close off the connection.
`boolean`	`isClosed()` Returns true if this connection has been (logically) closed.
`boolean`	`isConnectionAlive()` Sends a test query to the underlying connection and return true if connection is alive.
`boolean`	`isExpired()` Returns true if the given connection has exceeded the maxConnectionAge.
`protected boolean`	`isExpired(long currentTime)` Returns true if the given connection has exceeded the maxConnectionAge.
`protected boolean`	`isInReplayMode()`
`boolean`	`isLogStatementsEnabled()` Returns true if logging of statements is enabled
`boolean`	`isPossiblyBroken()` Gets true if connection has triggered an exception at some point.
`boolean`	`isReadOnly()`
`protected boolean`	`isTxResolved()` If true, autocommit is set to true or else commit/rollback has been called.
`boolean`	`isValid(int timeout)`
`boolean`	`isWrapperFor(Class<?> iface)`
`protected SQLException`	`markPossiblyBroken(SQLException e)` Given an exception, flag the connection (or database) as being potentially broken.
`String`	`nativeSQL(String sql)`
`protected Connection`	`obtainInternalConnection(BoneCP pool, String url)` Obtains a database connection, retrying if necessary.
`CallableStatement`	`prepareCall(String sql)`
`CallableStatement`	`prepareCall(String sql, int resultSetType, int resultSetConcurrency)`
`CallableStatement`	`prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`PreparedStatement`	`prepareStatement(String sql)`
`PreparedStatement`	`prepareStatement(String sql, int autoGeneratedKeys)`
`PreparedStatement`	`prepareStatement(String sql, int[] columnIndexes)`
`PreparedStatement`	`prepareStatement(String sql, int resultSetType, int resultSetConcurrency)`
`PreparedStatement`	`prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`PreparedStatement`	`prepareStatement(String sql, String[] columnNames)`
`ConnectionHandle`	`recreateConnectionHandle()` Creates the connection handle again.
`void`	`refreshConnection()` Destroys the internal connection handle and creates a new one.
`void`	`releaseSavepoint(Savepoint savepoint)`
`protected void`	`renewConnection()` Renews this connection, i.e.
`void`	`rollback()`
`void`	`rollback(Savepoint savepoint)`
`void`	`sendInitSQL()` Sends any configured SQL init statement.
`void`	`setAutoCommit(boolean autoCommit)`
`protected void`	`setAutoCommitStackTrace(String autoCommitStackTrace)` Sets the autoCommitStackTrace.
`void`	`setCatalog(String catalog)`
`void`	`setClientInfo(Properties properties)`
`void`	`setClientInfo(String name, String value)`
`protected void`	`setConnectionLastResetInMs(long connectionLastReset)`
`protected void`	`setConnectionLastUsedInMs(long connectionLastUsed)`
`void`	`setDebugHandle(Object debugHandle)` Sets a debugHandle, an object that is not used by the connection pool at all but may be set by an application to track this particular connection handle for any purpose it deems fit.
`void`	`setHoldability(int holdability)`
`protected void`	`setInReplayMode(boolean inReplayMode)`
`void`	`setInternalConnection(Connection rawConnection)` Sets the internal connection to use.
`void`	`setLogStatementsEnabled(boolean logStatementsEnabled)` Enable or disable logging of this connection.
`void`	`setNetworkTimeout(Executor executor, int milliseconds)`
`protected void`	`setOriginatingPartition(ConnectionPartition originatingPartition)` Sets Originating partition
`void`	`setReadOnly(boolean readOnly)`
`protected void`	`setReplayLog(List<ReplayLog> replayLog)` Sets the transaction history log
`Savepoint`	`setSavepoint()`
`Savepoint`	`setSavepoint(String name)`
`void`	`setSchema(String schema)`
`protected void`	`setThreadWatch(Thread threadWatch)` Sets the thread watching over this connection.
`void`	`setTransactionIsolation(int level)`
`void`	`setTypeMap(Map<String,Class<?>> map)`
`protected void`	`untrackStatement(StatementHandle statement)` Stop tracking the given statement.
`<T> T`	`unwrap(Class<T> iface)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - possiblyBroken
```
protected boolean possiblyBroken
```
    If true, this connection might have failed communicating with the database. We assume that exceptions should be rare here i.e. the normal case is assumed to succeed.
  - logicallyClosed
```
protected boolean logicallyClosed
```
    If true, we've called close() on this connection.
  - statementCachingEnabled
```
protected boolean statementCachingEnabled
```
    Set to true if we have statement caching enabled.
  - recoveryResult
```
protected TransactionRecoveryResult recoveryResult
```
    Map of translations + result from last recovery.
  - url
```
protected String url
```
    Connection url.
  - threadUsingConnection
```
protected Thread threadUsingConnection
```
    Keep track of the thread.
  - txResolved
```
protected boolean txResolved
```
    If true, transaction has been marked as COMMITed or ROLLBACKed.
  - detectUnresolvedTransactions
```
protected boolean detectUnresolvedTransactions
```
    Config setting.
  - autoCommitStackTrace
```
protected String autoCommitStackTrace
```
    Stack track dump.
  - inUseInThreadLocalContext
```
protected AtomicBoolean inUseInThreadLocalContext
```
    If true, this connection is in use in a thread-local context.
- Method Detail
  - createConnectionHandle
```
public static ConnectionHandle createConnectionHandle(String url,
                                      String username,
                                      String password,
                                      BoneCP pool)
                                               throws SQLException
```
    Create a connection Handle.
    
    Parameters:
    url - JDBC connection string
    username - user to use
    password - password for db
    pool - pool handle.
    
    Returns:
    connection handle.
    
    Throws:
    
    SQLException - on error
  - recreateConnectionHandle
```
public ConnectionHandle recreateConnectionHandle()
                                          throws SQLException
```
    Creates the connection handle again. We use this method to create a brand new connection handle. That way if the application (wrongly) tries to do something else with the connection that has already been "closed", it will fail.
    
    Returns:
    ConnectionHandle
    
    Throws:
    
    SQLException
  - obtainInternalConnection
```
protected Connection obtainInternalConnection(BoneCP pool,
                                  String url)
                                       throws SQLException
```
    Obtains a database connection, retrying if necessary.
    
    Parameters:
    pool - pool handle
    url - url to obtain connection from
    
    Returns:
    A DB connection.
    
    Throws:
    
    SQLException
  - createTestConnectionHandle
```
protected static ConnectionHandle createTestConnectionHandle(Connection connection,
                                          IStatementCache preparedStatementCache,
                                          IStatementCache callableStatementCache,
                                          BoneCP pool)
```
    Private -- used solely for unit testing.
    
    Parameters:
    connection -
    preparedStatementCache -
    callableStatementCache -
    pool -
    
    Returns:
    Connection Handle
  - sendInitSQL
```
public void sendInitSQL()
                 throws SQLException
```
    Sends any configured SQL init statement.
    
    Throws:
    
    SQLException - on error
  - markPossiblyBroken
```
protected SQLException markPossiblyBroken(SQLException e)
```
    Given an exception, flag the connection (or database) as being potentially broken. If the exception is a data-specific exception, do nothing except throw it back to the application.
    
    Parameters:
    e - SQLException e
    
    Returns:
    SQLException for further processing
  - clearWarnings
```
public void clearWarnings()
                   throws SQLException
```
    Specified by:
    
    clearWarnings in interface Connection
    
    Throws:
    
    SQLException
  - close
```
public void close()
           throws SQLException
```
    Release the connection if called.
    
    Specified by:
    
    close in interface AutoCloseable
    
    Specified by:
    
    close in interface Connection
    
    Throws:
    
    SQLException - Never really thrown
  - internalClose
```
protected void internalClose()
                      throws SQLException
```
    Close off the connection.
    
    Throws:
    
    SQLException
  - commit
```
public void commit()
            throws SQLException
```
    Specified by:
    
    commit in interface Connection
    
    Throws:
    
    SQLException
  - getClientInfo
```
public Properties getClientInfo()
                         throws SQLException
```
    Specified by:
    
    getClientInfo in interface Connection
    
    Throws:
    
    SQLException
  - getClientInfo
```
public String getClientInfo(String name)
                     throws SQLException
```
    Specified by:
    
    getClientInfo in interface Connection
    
    Throws:
    
    SQLException
  - isValid
```
public boolean isValid(int timeout)
                throws SQLException
```
    Specified by:
    
    isValid in interface Connection
    
    Throws:
    
    SQLException
  - isWrapperFor
```
public boolean isWrapperFor(Class<?> iface)
                     throws SQLException
```
    Specified by:
    
    isWrapperFor in interface Wrapper
    
    Throws:
    
    SQLException
  - unwrap
```
public <T> T unwrap(Class<T> iface)
         throws SQLException
```
    Specified by:
    
    unwrap in interface Wrapper
    
    Throws:
    
    SQLException
  - setClientInfo
```
public void setClientInfo(Properties properties)
                   throws SQLClientInfoException
```
    Specified by:
    
    setClientInfo in interface Connection
    
    Throws:
    
    SQLClientInfoException
  - setClientInfo
```
public void setClientInfo(String name,
                 String value)
                   throws SQLClientInfoException
```
    Specified by:
    
    setClientInfo in interface Connection
    
    Throws:
    
    SQLClientInfoException
  - createStruct
```
public Struct createStruct(String typeName,
                  Object[] attributes)
                    throws SQLException
```
    Specified by:
    
    createStruct in interface Connection
    
    Throws:
    
    SQLException
  - createArrayOf
```
public Array createArrayOf(String typeName,
                  Object[] elements)
                    throws SQLException
```
    Specified by:
    
    createArrayOf in interface Connection
    
    Throws:
    
    SQLException
  - createBlob
```
public Blob createBlob()
                throws SQLException
```
    Specified by:
    
    createBlob in interface Connection
    
    Throws:
    
    SQLException
  - createClob
```
public Clob createClob()
                throws SQLException
```
    Specified by:
    
    createClob in interface Connection
    
    Throws:
    
    SQLException
  - createNClob
```
public NClob createNClob()
                  throws SQLException
```
    Specified by:
    
    createNClob in interface Connection
    
    Throws:
    
    SQLException
  - createSQLXML
```
public SQLXML createSQLXML()
                    throws SQLException
```
    Specified by:
    
    createSQLXML in interface Connection
    
    Throws:
    
    SQLException
  - setSchema
```
public void setSchema(String schema)
               throws SQLException
```
    Specified by:
    
    setSchema in interface Connection
    
    Throws:
    
    SQLException
  - getSchema
```
public String getSchema()
                 throws SQLException
```
    Specified by:
    
    getSchema in interface Connection
    
    Throws:
    
    SQLException
  - abort
```
public void abort(Executor executor)
           throws SQLException
```
    Specified by:
    
    abort in interface Connection
    
    Throws:
    
    SQLException
  - setNetworkTimeout
```
public void setNetworkTimeout(Executor executor,
                     int milliseconds)
                       throws SQLException
```
    Specified by:
    
    setNetworkTimeout in interface Connection
    
    Throws:
    
    SQLException
  - getNetworkTimeout
```
public int getNetworkTimeout()
                      throws SQLException
```
    Specified by:
    
    getNetworkTimeout in interface Connection
    
    Throws:
    
    SQLException
  - createStatement
```
public Statement createStatement()
                          throws SQLException
```
    Specified by:
    
    createStatement in interface Connection
    
    Throws:
    
    SQLException
  - createStatement
```
public Statement createStatement(int resultSetType,
                        int resultSetConcurrency)
                          throws SQLException
```
    Specified by:
    
    createStatement in interface Connection
    
    Throws:
    
    SQLException
  - createStatement
```
public Statement createStatement(int resultSetType,
                        int resultSetConcurrency,
                        int resultSetHoldability)
                          throws SQLException
```
    Specified by:
    
    createStatement in interface Connection
    
    Throws:
    
    SQLException
  - getAutoCommit
```
public boolean getAutoCommit()
                      throws SQLException
```
    Specified by:
    
    getAutoCommit in interface Connection
    
    Throws:
    
    SQLException
  - getCatalog
```
public String getCatalog()
                  throws SQLException
```
    Specified by:
    
    getCatalog in interface Connection
    
    Throws:
    
    SQLException
  - getHoldability
```
public int getHoldability()
                   throws SQLException
```
    Specified by:
    
    getHoldability in interface Connection
    
    Throws:
    
    SQLException
  - getMetaData
```
public DatabaseMetaData getMetaData()
                             throws SQLException
```
    Specified by:
    
    getMetaData in interface Connection
    
    Throws:
    
    SQLException
  - getTransactionIsolation
```
public int getTransactionIsolation()
                            throws SQLException
```
    Specified by:
    
    getTransactionIsolation in interface Connection
    
    Throws:
    
    SQLException
  - getTypeMap
```
public Map<String,Class<?>> getTypeMap()
                                throws SQLException
```
    Specified by:
    
    getTypeMap in interface Connection
    
    Throws:
    
    SQLException
  - getWarnings
```
public SQLWarning getWarnings()
                       throws SQLException
```
    Specified by:
    
    getWarnings in interface Connection
    
    Throws:
    
    SQLException
  - isClosed
```
public boolean isClosed()
```
    Returns true if this connection has been (logically) closed.
    
    Specified by:
    
    isClosed in interface Connection
    
    Returns:
    the logicallyClosed setting.
  - isReadOnly
```
public boolean isReadOnly()
                   throws SQLException
```
    Specified by:
    
    isReadOnly in interface Connection
    
    Throws:
    
    SQLException
  - nativeSQL
```
public String nativeSQL(String sql)
                 throws SQLException
```
    Specified by:
    
    nativeSQL in interface Connection
    
    Throws:
    
    SQLException
  - prepareCall
```
public CallableStatement prepareCall(String sql)
                              throws SQLException
```
    Specified by:
    
    prepareCall in interface Connection
    
    Throws:
    
    SQLException
  - prepareCall
```
public CallableStatement prepareCall(String sql,
                            int resultSetType,
                            int resultSetConcurrency)
                              throws SQLException
```
    Specified by:
    
    prepareCall in interface Connection
    
    Throws:
    
    SQLException
  - prepareCall
```
public CallableStatement prepareCall(String sql,
                            int resultSetType,
                            int resultSetConcurrency,
                            int resultSetHoldability)
                              throws SQLException
```
    Specified by:
    
    prepareCall in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql,
                                 int autoGeneratedKeys)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql,
                                 int[] columnIndexes)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql,
                                 String[] columnNames)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql,
                                 int resultSetType,
                                 int resultSetConcurrency)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - prepareStatement
```
public PreparedStatement prepareStatement(String sql,
                                 int resultSetType,
                                 int resultSetConcurrency,
                                 int resultSetHoldability)
                                   throws SQLException
```
    Specified by:
    
    prepareStatement in interface Connection
    
    Throws:
    
    SQLException
  - releaseSavepoint
```
public void releaseSavepoint(Savepoint savepoint)
                      throws SQLException
```
    Specified by:
    
    releaseSavepoint in interface Connection
    
    Throws:
    
    SQLException
  - rollback
```
public void rollback()
              throws SQLException
```
    Specified by:
    
    rollback in interface Connection
    
    Throws:
    
    SQLException
  - rollback
```
public void rollback(Savepoint savepoint)
              throws SQLException
```
    Specified by:
    
    rollback in interface Connection
    
    Throws:
    
    SQLException
  - setAutoCommit
```
public void setAutoCommit(boolean autoCommit)
                   throws SQLException
```
    Specified by:
    
    setAutoCommit in interface Connection
    
    Throws:
    
    SQLException
  - setCatalog
```
public void setCatalog(String catalog)
                throws SQLException
```
    Specified by:
    
    setCatalog in interface Connection
    
    Throws:
    
    SQLException
  - setHoldability
```
public void setHoldability(int holdability)
                    throws SQLException
```
    Specified by:
    
    setHoldability in interface Connection
    
    Throws:
    
    SQLException
  - setReadOnly
```
public void setReadOnly(boolean readOnly)
                 throws SQLException
```
    Specified by:
    
    setReadOnly in interface Connection
    
    Throws:
    
    SQLException
  - setSavepoint
```
public Savepoint setSavepoint()
                       throws SQLException
```
    Specified by:
    
    setSavepoint in interface Connection
    
    Throws:
    
    SQLException
  - setSavepoint
```
public Savepoint setSavepoint(String name)
                       throws SQLException
```
    Specified by:
    
    setSavepoint in interface Connection
    
    Throws:
    
    SQLException
  - setTransactionIsolation
```
public void setTransactionIsolation(int level)
                             throws SQLException
```
    Specified by:
    
    setTransactionIsolation in interface Connection
    
    Throws:
    
    SQLException
  - setTypeMap
```
public void setTypeMap(Map<String,Class<?>> map)
                throws SQLException
```
    Specified by:
    
    setTypeMap in interface Connection
    
    Throws:
    
    SQLException
  - getConnectionLastUsedInMs
```
public long getConnectionLastUsedInMs()
```
    Returns:
    the connectionLastUsed
  - getConnectionLastUsed
```
@Deprecated
public long getConnectionLastUsed()
```
    Deprecated. Use getConnectionLastUsedInMs() instead.
    
    Deprecated. Use getConnectionLastUsedInMs() instead.
    
    Returns:
    the connectionLastUsed
  - setConnectionLastUsedInMs
```
protected void setConnectionLastUsedInMs(long connectionLastUsed)
```
    Parameters:
    connectionLastUsed - the connectionLastUsed to set
  - getConnectionLastResetInMs
```
public long getConnectionLastResetInMs()
```
    Returns:
    the connectionLastReset
  - getConnectionLastReset
```
@Deprecated
public long getConnectionLastReset()
```
    Deprecated. Please use getConnectionLastResetInMs() instead
    
    Deprecated. Use getConnectionLastResetInMs() instead.
    
    Returns:
    the connectionLastReset
  - setConnectionLastResetInMs
```
protected void setConnectionLastResetInMs(long connectionLastReset)
```
    Parameters:
    connectionLastReset - the connectionLastReset to set
  - isPossiblyBroken
```
public boolean isPossiblyBroken()
```
    Gets true if connection has triggered an exception at some point.
    
    Returns:
    true if the connection has triggered an error
  - getOriginatingPartition
```
public ConnectionPartition getOriginatingPartition()
```
    Gets the partition this came from.
    
    Returns:
    the partition this came from
  - setOriginatingPartition
```
protected void setOriginatingPartition(ConnectionPartition originatingPartition)
```
    Sets Originating partition
    
    Parameters:
    originatingPartition - to set
  - renewConnection
```
protected void renewConnection()
```
    Renews this connection, i.e. Sets this connection to be logically open (although it was never really physically closed)
  - clearStatementCaches
```
protected void clearStatementCaches(boolean internalClose)
```
    Clears out the statement handles.
    
    Parameters:
    internalClose - if true, close the inner statement handle too.
  - getDebugHandle
```
public Object getDebugHandle()
```
    Returns a debug handle as previously set by an application
    
    Returns:
    DebugHandle
  - setDebugHandle
```
public void setDebugHandle(Object debugHandle)
```
    Sets a debugHandle, an object that is not used by the connection pool at all but may be set by an application to track this particular connection handle for any purpose it deems fit.
    
    Parameters:
    debugHandle - any object.
  - getRawConnection
```
@Deprecated
public Connection getRawConnection()
```
    Deprecated.
    
    Deprecated. Please use getInternalConnection() instead.
    
    Returns:
    the raw connection
  - getInternalConnection
```
public Connection getInternalConnection()
```
    Returns the internal connection as obtained via the JDBC driver.
    
    Returns:
    the raw connection
  - getConnectionHook
```
public ConnectionHook getConnectionHook()
```
    Returns the configured connection hook object.
    
    Returns:
    the connectionHook that was set in the config
  - isLogStatementsEnabled
```
public boolean isLogStatementsEnabled()
```
    Returns true if logging of statements is enabled
    
    Returns:
    logStatementsEnabled status
  - setLogStatementsEnabled
```
public void setLogStatementsEnabled(boolean logStatementsEnabled)
```
    Enable or disable logging of this connection.
    
    Parameters:
    logStatementsEnabled - true to enable logging, false to disable.
  - isInReplayMode
```
protected boolean isInReplayMode()
```
    Returns:
    the inReplayMode
  - setInReplayMode
```
protected void setInReplayMode(boolean inReplayMode)
```
    Parameters:
    inReplayMode - the inReplayMode to set
  - isConnectionAlive
```
public boolean isConnectionAlive()
```
    Sends a test query to the underlying connection and return true if connection is alive.
    
    Returns:
    True if connection is valid, false otherwise.
  - setInternalConnection
```
public void setInternalConnection(Connection rawConnection)
```
    Sets the internal connection to use. Be careful how to use this method, normally you should never need it! This is here for odd use cases only!
    
    Parameters:
    rawConnection - to set
  - getPool
```
public BoneCP getPool()
```
    Returns a handle to the global pool from where this connection was obtained.
    
    Returns:
    BoneCP handle
  - getReplayLog
```
public List<ReplayLog> getReplayLog()
```
    Returns transaction history log
    
    Returns:
    replay list
  - setReplayLog
```
protected void setReplayLog(List<ReplayLog> replayLog)
```
    Sets the transaction history log
    
    Parameters:
    replayLog - to set.
  - getProxyTarget
```
public Object getProxyTarget()
```
    This method will be intercepted by the proxy if it is enabled to return the internal target.
    
    Returns:
    the target.
  - getThreadUsingConnection
```
public Thread getThreadUsingConnection()
```
    Returns the thread that is currently utilizing this connection.
    
    Returns:
    the threadUsingConnection
  - getConnectionCreationTime
```
@Deprecated
public long getConnectionCreationTime()
```
    Deprecated. please use getConnectionCreationTimeInMs() instead.
    
    Deprecated. Use getConnectionCreationTimeInMs() instead.
    
    Returns:
    connectionCreationTime
  - getConnectionCreationTimeInMs
```
public long getConnectionCreationTimeInMs()
```
    Returns the connectionCreationTime field.
    
    Returns:
    connectionCreationTime
  - isExpired
```
public boolean isExpired()
```
    Returns true if the given connection has exceeded the maxConnectionAge.
    
    Returns:
    true if the connection has expired.
  - isExpired
```
protected boolean isExpired(long currentTime)
```
    Returns true if the given connection has exceeded the maxConnectionAge.
    
    Parameters:
    currentTime - current time to use.
    
    Returns:
    true if the connection has expired.
  - setThreadWatch
```
protected void setThreadWatch(Thread threadWatch)
```
    Sets the thread watching over this connection.
    
    Parameters:
    threadWatch - the threadWatch to set
  - getThreadWatch
```
public Thread getThreadWatch()
```
    Returns the thread watching over this connection.
    
    Returns:
    threadWatch
  - isTxResolved
```
protected boolean isTxResolved()
```
    If true, autocommit is set to true or else commit/rollback has been called.
    
    Returns:
    true/false
  - getAutoCommitStackTrace
```
protected String getAutoCommitStackTrace()
```
    Returns the autoCommitStackTrace field.
    
    Returns:
    autoCommitStackTrace
  - setAutoCommitStackTrace
```
protected void setAutoCommitStackTrace(String autoCommitStackTrace)
```
    Sets the autoCommitStackTrace.
    
    Parameters:
    autoCommitStackTrace - the autoCommitStackTrace to set
  - refreshConnection
```
public void refreshConnection()
                       throws SQLException
```
    Destroys the internal connection handle and creates a new one.
    
    Throws:
    
    SQLException
  - untrackStatement
```
protected void untrackStatement(StatementHandle statement)
```
    Stop tracking the given statement.
    
    Parameters:
    statement -
  - getUrl
```
public String getUrl()
```
    Returns the url field.
    
    Returns:
    url

Class ConnectionHandle

Field Summary

Fields inherited from interface java.sql.Connection

Method Summary

Methods inherited from class java.lang.Object

Field Detail

possiblyBroken

logicallyClosed

statementCachingEnabled

recoveryResult

url

threadUsingConnection

txResolved

detectUnresolvedTransactions

autoCommitStackTrace

inUseInThreadLocalContext

Method Detail

createConnectionHandle

recreateConnectionHandle

obtainInternalConnection

createTestConnectionHandle

sendInitSQL

markPossiblyBroken

clearWarnings

close

internalClose

commit

getClientInfo

getClientInfo

isValid

isWrapperFor

unwrap

setClientInfo

setClientInfo

createStruct

createArrayOf

createBlob

createClob

createNClob

createSQLXML

setSchema

getSchema

abort

setNetworkTimeout

getNetworkTimeout

createStatement

createStatement

createStatement

getAutoCommit

getCatalog

getHoldability

getMetaData

getTransactionIsolation

getTypeMap

getWarnings

isClosed

isReadOnly

nativeSQL

prepareCall

prepareCall

prepareCall

prepareStatement

prepareStatement

prepareStatement

prepareStatement

prepareStatement

prepareStatement

releaseSavepoint

rollback

rollback

setAutoCommit

setCatalog

setHoldability

setReadOnly

setSavepoint

setSavepoint

setTransactionIsolation

setTypeMap

getConnectionLastUsedInMs

getConnectionLastUsed