Module com.aoapps.sql.tracker

Package com.aoapps.sql.tracker

Interface ConnectionTracker

All Superinterfaces:

AutoCloseable, Connection, ConnectionWrapper, OnCloseHandler, TrackedArrays, TrackedBlobs, TrackedCallableStatements, TrackedClobs, TrackedDatabaseMetaDatas, TrackedInputStreams, TrackedNClobs, TrackedOutputStreams, TrackedParameterMetaDatas, TrackedPreparedStatements, TrackedReaders, TrackedRefs, TrackedResultSetMetaDatas, TrackedResultSets, TrackedRowIds, TrackedSavepoints, TrackedSQLDatas, TrackedSQLInputs, TrackedSQLOutputs, TrackedSQLXMLs, TrackedStatements, TrackedStructs, TrackedWriters, Wrapper, Wrapper

All Known Implementing Classes:

ConnectionTrackerImpl

public interface ConnectionTracker
extends ConnectionWrapper, OnCloseHandler, TrackedArrays, TrackedBlobs, TrackedCallableStatements, TrackedClobs, TrackedDatabaseMetaDatas, TrackedInputStreams, TrackedNClobs, TrackedOutputStreams, TrackedParameterMetaDatas, TrackedPreparedStatements, TrackedReaders, TrackedRefs, TrackedResultSets, TrackedResultSetMetaDatas, TrackedRowIds, TrackedSQLDatas, TrackedSQLInputs, TrackedSQLOutputs, TrackedSQLXMLs, TrackedSavepoints, TrackedStatements, TrackedStructs, TrackedWriters

Tracks a Connection for unclosed or unfreed objects.

Author:

AO Industries, Inc.

Field Summary

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Method Summary

Modifier and Type	Method	Description
void	abort(Executor executor)	Calls onClose handlers, clears all tracking, then calls ConnectionTrackerImpl.doAbort(java.util.concurrent.Executor).
void	close()	Calls onClose handlers, closes all tracked objects, rolls-back any transaction in-progress and puts back in auto-commit mode, then calls ConnectionTrackerImpl.doClose().
void	commit()	Removes tracking of savepoints while committing the transaction.
void	releaseSavepoint(Savepoint savepoint)	Removes tracking while releasing the savepoint.
void	rollback()	Removes tracking of savepoints while rolling-back the transaction.
void	rollback(Savepoint savepoint)	Removes tracking of all savepoints after the given savepoint, the rolls-back to the given savepoint.
void	setAutoCommit(boolean autoCommit)	Removes tracking of savepoints when auto-commit mode is enabled (which commits any transaction in-progress).

Methods inherited from interface java.sql.Connection

beginRequest, endRequest, setShardingKey, setShardingKey, setShardingKeyIfValid, setShardingKeyIfValid

Methods inherited from interface com.aoapps.sql.wrapper.ConnectionWrapper

clearWarnings, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getAutoCommit, getCatalog, getClientInfo, getClientInfo, getHoldability, getMetaData, getNetworkTimeout, getSchema, getTransactionIsolation, getTypeMap, getWarnings, getWrapped, getWrappedConnection, isClosed, isReadOnly, isValid, nativeSQL, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, setCatalog, setClientInfo, setClientInfo, setHoldability, setNetworkTimeout, setReadOnly, setSavepoint, setSavepoint, setSchema, setTransactionIsolation, setTypeMap

Methods inherited from interface com.aoapps.sql.tracker.OnCloseHandler

addOnClose

Methods inherited from interface com.aoapps.sql.tracker.TrackedArrays

getTrackedArrays

Methods inherited from interface com.aoapps.sql.tracker.TrackedBlobs

getTrackedBlobs

Methods inherited from interface com.aoapps.sql.tracker.TrackedCallableStatements

getTrackedCallableStatements

Methods inherited from interface com.aoapps.sql.tracker.TrackedClobs

getTrackedClobs

Methods inherited from interface com.aoapps.sql.tracker.TrackedDatabaseMetaDatas

getTrackedDatabaseMetaDatas

Methods inherited from interface com.aoapps.sql.tracker.TrackedInputStreams

getTrackedInputStreams

Methods inherited from interface com.aoapps.sql.tracker.TrackedNClobs

getTrackedNClobs

Methods inherited from interface com.aoapps.sql.tracker.TrackedOutputStreams

getTrackedOutputStreams

Methods inherited from interface com.aoapps.sql.tracker.TrackedParameterMetaDatas

getTrackedParameterMetaDatas

Methods inherited from interface com.aoapps.sql.tracker.TrackedPreparedStatements

getTrackedPreparedStatements

Methods inherited from interface com.aoapps.sql.tracker.TrackedReaders

getTrackedReaders

Methods inherited from interface com.aoapps.sql.tracker.TrackedRefs

getTrackedRefs

Methods inherited from interface com.aoapps.sql.tracker.TrackedResultSetMetaDatas

getTrackedResultSetMetaDatas

Methods inherited from interface com.aoapps.sql.tracker.TrackedResultSets

getTrackedResultSets

Methods inherited from interface com.aoapps.sql.tracker.TrackedRowIds

getTrackedRowIds

Methods inherited from interface com.aoapps.sql.tracker.TrackedSavepoints

getTrackedSavepoints

Methods inherited from interface com.aoapps.sql.tracker.TrackedSQLDatas

getTrackedSQLDatas

Methods inherited from interface com.aoapps.sql.tracker.TrackedSQLInputs

getTrackedSQLInputs

Methods inherited from interface com.aoapps.sql.tracker.TrackedSQLOutputs

getTrackedSQLOutputs

Methods inherited from interface com.aoapps.sql.tracker.TrackedSQLXMLs

getTrackedSQLXMLs

Methods inherited from interface com.aoapps.sql.tracker.TrackedStatements

getTrackedStatements

Methods inherited from interface com.aoapps.sql.tracker.TrackedStructs

getTrackedStructs

Methods inherited from interface com.aoapps.sql.tracker.TrackedWriters

getTrackedWriters

Methods inherited from interface com.aoapps.sql.wrapper.Wrapper

isWrapperFor, unwrap

Method Details

setAutoCommit

void setAutoCommit(boolean autoCommit)
            throws SQLException

Removes tracking of savepoints when auto-commit mode is enabled (which commits any transaction in-progress).

Specified by:

setAutoCommit in interface Connection

Specified by:

setAutoCommit in interface ConnectionWrapper

Throws:

SQLException

commit

void commit()
     throws SQLException

Removes tracking of savepoints while committing the transaction.

Specified by:

commit in interface Connection

Specified by:

commit in interface ConnectionWrapper

Throws:

SQLException

rollback

void rollback()
       throws SQLException

Removes tracking of savepoints while rolling-back the transaction.

Specified by:

rollback in interface Connection

Specified by:

rollback in interface ConnectionWrapper

Throws:

SQLException

close

void close()
    throws SQLException

Calls onClose handlers, closes all tracked objects, rolls-back any transaction in-progress and puts back in auto-commit mode, then calls ConnectionTrackerImpl.doClose().

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection

Specified by:

close in interface ConnectionWrapper

Throws:

SQLException

See Also:

• OnCloseHandler.addOnClose(java.lang.Runnable)

rollback

void rollback(Savepoint savepoint)
       throws SQLException

Removes tracking of all savepoints after the given savepoint, the rolls-back to the given savepoint.

Specified by:

rollback in interface Connection

Specified by:

rollback in interface ConnectionWrapper

Throws:

SQLException

releaseSavepoint

void releaseSavepoint(Savepoint savepoint)
               throws SQLException

Removes tracking while releasing the savepoint.

Specified by:

releaseSavepoint in interface Connection

Specified by:

releaseSavepoint in interface ConnectionWrapper

Throws:

SQLException

abort

void abort(Executor executor)
    throws SQLException

Calls onClose handlers, clears all tracking, then calls ConnectionTrackerImpl.doAbort(java.util.concurrent.Executor). Trusts the underlying implementation of Connection.abort(java.util.concurrent.Executor) will free all resources.

Specified by:

abort in interface Connection

Specified by:

abort in interface ConnectionWrapper

Throws:

SQLException

See Also:

• OnCloseHandler.addOnClose(java.lang.Runnable)