Package org.apache.commons.dbcp2

Class PoolingDataSource.PoolGuardConnectionWrapper<D extends Connection>

java.lang.Object

org.apache.commons.dbcp2.AbandonedTrace

org.apache.commons.dbcp2.DelegatingConnection<D>

org.apache.commons.dbcp2.PoolingDataSource.PoolGuardConnectionWrapper<D>

All Implemented Interfaces:

AutoCloseable, Connection, Wrapper, org.apache.commons.pool2.TrackedUse

Enclosing class:

PoolingDataSource<C extends Connection>

private final class PoolingDataSource.PoolGuardConnectionWrapper<D extends Connection>
extends DelegatingConnection<D>

PoolGuardConnectionWrapper is a Connection wrapper that makes sure a closed connection cannot be used anymore.

Since:

2.0

Field Summary

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

Constructors

Constructor	Description
PoolGuardConnectionWrapper(D delegate)

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the underlying connection, and close any Statements that were not explicitly closed.
D	getDelegate()	Returns my underlying Connection.
Connection	getInnermostDelegate()	If my underlying Connection is not a DelegatingConnection, returns it, otherwise recursively invokes this method on my delegate.
boolean	isClosed()

Methods inherited from class org.apache.commons.dbcp2.DelegatingConnection

abort, activate, checkOpen, clearCachedState, clearWarnings, closeInternal, commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getAutoCommit, getCacheState, getCatalog, getClientInfo, getClientInfo, getDefaultQueryTimeout, getDefaultQueryTimeoutDuration, getDelegateInternal, getHoldability, getInnermostDelegateInternal, getMetaData, getNetworkTimeout, getSchema, getTransactionIsolation, getTypeMap, getWarnings, handleException, handleExceptionNoThrow, innermostDelegateEquals, isClosedInternal, isReadOnly, isValid, isValid, isWrapperFor, nativeSQL, passivate, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, releaseSavepoint, rollback, rollback, setAutoCommit, setCacheState, setCatalog, setClientInfo, setClientInfo, setClosedInternal, setDefaultQueryTimeout, setDefaultQueryTimeout, setDelegate, setHoldability, setNetworkTimeout, setReadOnly, setSavepoint, setSavepoint, setSchema, setTransactionIsolation, setTypeMap, toString, unwrap

Methods inherited from class org.apache.commons.dbcp2.AbandonedTrace

add, addTrace, clearTrace, close, getLastUsed, getLastUsedInstant, getTrace, removeThisTrace, removeTrace, setLastUsed, setLastUsed, setLastUsed

Methods inherited from class java.lang.Object

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

Constructor Details

PoolGuardConnectionWrapper

PoolGuardConnectionWrapper(D delegate)

Method Details

close

public void close()
           throws SQLException

Description copied from class: DelegatingConnection

Closes the underlying connection, and close any Statements that were not explicitly closed. Sub-classes that override this method must:

1. Call DelegatingConnection.passivate()
2. Call close (or the equivalent appropriate action) on the wrapped connection
3. Set closed to false

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection

Overrides:

close in class DelegatingConnection<D extends Connection>

Throws:

SQLException - Ignored here, for subclasses.

getDelegate

public D getDelegate()

Description copied from class: DelegatingConnection

Returns my underlying Connection.

Overrides:

getDelegate in class DelegatingConnection<D extends Connection>

Returns:

my underlying Connection.

See Also:

• DelegatingConnection.getDelegate()

getInnermostDelegate

public Connection getInnermostDelegate()

Description copied from class: DelegatingConnection

If my underlying Connection is not a DelegatingConnection, returns it, otherwise recursively invokes this method on my delegate.

Hence this method will return the first delegate that is not a DelegatingConnection, or null when no non-DelegatingConnection delegate can be found by traversing this chain.

This method is useful when you may have nested DelegatingConnections, and you want to make sure to obtain a "genuine" Connection.

Overrides:

getInnermostDelegate in class DelegatingConnection<D extends Connection>

Returns:

innermost delegate.

See Also:

• DelegatingConnection.getInnermostDelegate()

isClosed

public boolean isClosed()
                 throws SQLException

Specified by:

isClosed in interface Connection

Overrides:

isClosed in class DelegatingConnection<D extends Connection>

Throws:

SQLException