Package io.agroal.pool

Class ConnectionHandler

java.lang.Object

io.agroal.pool.ConnectionHandler

All Implemented Interfaces:

Acquirable, TransactionAware

public final class ConnectionHandler
extends Object
implements TransactionAware, Acquirable

Author:

Luis Barreiro

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	ConnectionHandler.DirtyAttribute
static enum	ConnectionHandler.State

Nested classes/interfaces inherited from interface io.agroal.api.transaction.TransactionAware

TransactionAware.SQLCallable<T extends Object>

Constructor Summary

Constructors

Constructor	Description
ConnectionHandler(XAConnection xa, Pool pool)

Method Summary

Modifier and Type	Method	Description
boolean	acquire()
void	closeConnection()
ConnectionWrapper	connectionWrapper()
ConnectionWrapper	detachedWrapper()
StackTraceElement[]	getAcquisitionStackTrace()	Stack trace of the first acquisition for this connection
Connection	getConnection()
List<String>	getConnectionOperations()	Abbreviated list of all operation on the connection, for enhanced leak report
Thread	getHoldingThread()
StackTraceElement[]	getLastOperationStackTrace()	Stack trace for the last operation on this connection
XAResource	getXaResource()
boolean	isAcquirable()
boolean	isEnlisted()
boolean	isIdle(Duration timeout)
boolean	isLeak(Duration timeout)
boolean	isValid()
void	onConnectionWrapperClose(ConnectionWrapper wrapper, ConnectionWrapper.JdbcResourcesLeakReport leakReport)
Connection	rawConnection()
void	resetConnection()
void	setAcquisitionStackTrace(StackTraceElement[] stackTrace)	Stores a stack trace for leak report.
void	setDirtyAttribute(ConnectionHandler.DirtyAttribute attribute)
void	setFlushOnly()
void	setFlushOnly(SQLException se)
void	setHoldingThread(Thread holdingThread)
void	setMaxLifetimeTask(Future<?> maxLifetimeTask)
void	setState(ConnectionHandler.State newState)
boolean	setState(ConnectionHandler.State expected, ConnectionHandler.State newState)
void	touch()
void	traceConnectionOperation(String operation)	Abbreviated list of all operation on the connection, for enhanced leak report
void	transactionBeforeCompletion(boolean successful)
void	transactionCheckCallback(TransactionAware.SQLCallable<Boolean> transactionCheck)
void	transactionCommit()
void	transactionEnd()
void	transactionRollback()
void	transactionStart()
void	verifyEnlistment()

Methods inherited from class java.lang.Object

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

Constructor Details

ConnectionHandler

public ConnectionHandler(XAConnection xa,
 Pool pool)
                  throws SQLException

Throws:

SQLException

Method Details

connectionWrapper

public ConnectionWrapper connectionWrapper()

detachedWrapper

public ConnectionWrapper detachedWrapper()

onConnectionWrapperClose

public void onConnectionWrapperClose(ConnectionWrapper wrapper,
 ConnectionWrapper.JdbcResourcesLeakReport leakReport)
                              throws SQLException

Throws:

SQLException

rawConnection

public Connection rawConnection()

getXaResource

public XAResource getXaResource()

resetConnection

public void resetConnection()
                     throws SQLException

Throws:

SQLException

closeConnection

public void closeConnection()
                     throws SQLException

Throws:

SQLException

acquire

public boolean acquire()

Specified by:

acquire in interface Acquirable

isAcquirable

public boolean isAcquirable()

Specified by:

isAcquirable in interface Acquirable

setState

public boolean setState(ConnectionHandler.State expected,
 ConnectionHandler.State newState)

setState

public void setState(ConnectionHandler.State newState)

touch

public void touch()

isLeak

public boolean isLeak(Duration timeout)

isIdle

public boolean isIdle(Duration timeout)

setMaxLifetimeTask

public void setMaxLifetimeTask(Future<?> maxLifetimeTask)

isValid

public boolean isValid()

getHoldingThread

public Thread getHoldingThread()

setHoldingThread

public void setHoldingThread(Thread holdingThread)

traceConnectionOperation

public void traceConnectionOperation(String operation)

Abbreviated list of all operation on the connection, for enhanced leak report

getConnectionOperations

public List<String> getConnectionOperations()

Abbreviated list of all operation on the connection, for enhanced leak report

getAcquisitionStackTrace

public StackTraceElement[] getAcquisitionStackTrace()

Stack trace of the first acquisition for this connection

setAcquisitionStackTrace

public void setAcquisitionStackTrace(StackTraceElement[] stackTrace)

Stores a stack trace for leak report. Setting a value != null also enables tracing of operations on the connection

getLastOperationStackTrace

public StackTraceElement[] getLastOperationStackTrace()

Stack trace for the last operation on this connection

setDirtyAttribute

public void setDirtyAttribute(ConnectionHandler.DirtyAttribute attribute)

isEnlisted

public boolean isEnlisted()

getConnection

public Connection getConnection()

Specified by:

getConnection in interface TransactionAware

transactionStart

public void transactionStart()
                      throws SQLException

Specified by:

transactionStart in interface TransactionAware

Throws:

SQLException

transactionBeforeCompletion

public void transactionBeforeCompletion(boolean successful)

Specified by:

transactionBeforeCompletion in interface TransactionAware

transactionCommit

public void transactionCommit()
                       throws SQLException

Specified by:

transactionCommit in interface TransactionAware

Throws:

SQLException

transactionRollback

public void transactionRollback()
                         throws SQLException

Specified by:

transactionRollback in interface TransactionAware

Throws:

SQLException

transactionEnd

public void transactionEnd()
                    throws SQLException

Specified by:

transactionEnd in interface TransactionAware

Throws:

SQLException

transactionCheckCallback

public void transactionCheckCallback(TransactionAware.SQLCallable<Boolean> transactionCheck)

Specified by:

transactionCheckCallback in interface TransactionAware

verifyEnlistment

public void verifyEnlistment()
                      throws SQLException

Throws:

SQLException

setFlushOnly

public void setFlushOnly()

Specified by:

setFlushOnly in interface TransactionAware

setFlushOnly

public void setFlushOnly(SQLException se)