Package io.agroal.pool

Class ConnectionHandler

java.lang.Object

io.agroal.pool.ConnectionHandler

All Implemented Interfaces:

TransactionAware

public final class ConnectionHandler
extends Object
implements TransactionAware

Author:

Luis Barreiro

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ConnectionHandler.DirtyAttribute
static class	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 xaConnection, Pool pool)

Method Summary

Modifier and Type	Method	Description
void	closeConnection()
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	isEnlisted()
boolean	isIdle(Duration timeout)
boolean	isLeak(Duration timeout)
ConnectionWrapper	newConnectionWrapper()
ConnectionWrapper	newDetachedConnectionWrapper()
void	onConnectionWrapperClose(ConnectionWrapper wrapper, ConnectionWrapper.JdbcResourcesLeakReport leakReport)
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	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 Detail

ConnectionHandler

public ConnectionHandler(XAConnection xaConnection,
                         Pool pool)
                  throws SQLException

Throws:

SQLException

Method Detail

newConnectionWrapper

public ConnectionWrapper newConnectionWrapper()

newDetachedConnectionWrapper

public ConnectionWrapper newDetachedConnectionWrapper()

onConnectionWrapperClose

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

Throws:

SQLException

getConnection

public Connection getConnection()

Specified by:

getConnection in interface TransactionAware

getXaResource

public XAResource getXaResource()

resetConnection

public void resetConnection()
                     throws SQLException

Throws:

SQLException

closeConnection

public void closeConnection()
                     throws SQLException

Throws:

SQLException

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)

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()

transactionStart

public void transactionStart()
                      throws SQLException

Specified by:

transactionStart in interface TransactionAware

Throws:

SQLException

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)