bitronix.tm.resource.jdbc

Class JdbcPooledConnection

java.lang.Object

bitronix.tm.resource.common.AbstractXAStatefulHolder<T>

bitronix.tm.resource.common.AbstractXAResourceHolder<JdbcPooledConnection>

bitronix.tm.resource.jdbc.JdbcPooledConnection

All Implemented Interfaces:

StateChangeListener<JdbcPooledConnection>, XAResourceHolder<JdbcPooledConnection>, XAStatefulHolder<JdbcPooledConnection>, JdbcPooledConnectionMBean

public class JdbcPooledConnection
extends AbstractXAResourceHolder<JdbcPooledConnection>
implements StateChangeListener<JdbcPooledConnection>, JdbcPooledConnectionMBean

Implementation of a JDBC pooled connection wrapping vendor's XAConnection implementation.

Author:

Ludovic Orban, Brett Wooldridge

Nested Class Summary

Nested classes/interfaces inherited from interface bitronix.tm.resource.common.XAStatefulHolder

XAStatefulHolder.State

Constructor Summary

Constructors

Constructor and Description
JdbcPooledConnection(PoolingDataSource poolingDataSource, XAConnection xaConnection)

Method Summary

Modifier and Type	Method and Description
void	close() Close the physical connection that this XAStatefulHolder represents.
RecoveryXAResourceHolder	createRecoveryXAResourceHolder()
Date	getAcquisitionDate()
PreparedStatement	getCachedStatement(LruStatementCache.CacheKey key) Get a PreparedStatement from cache.
Object	getConnectionHandle() Create a disposable handler used to drive a pooled instance of XAStatefulHolder.
int	getJdbcVersion()
Date	getLastReleaseDate() Get the date at which this object was last released to the pool.
PoolingDataSource	getPoolingDataSource()
ResourceBean	getResourceBean() Get the ResourceBean which created this XAResourceHolder.
String	getStateDescription()
Collection<String>	getTransactionGtridsCurrentlyHoldingThis()
XAResource	getXAResource() Get the vendor's XAResource implementation of the wrapped resource.
List<JdbcPooledConnection>	getXAResourceHolders() Get the list of XAResourceHolders created by this XAStatefulHolder that are still open.
PreparedStatement	putCachedStatement(LruStatementCache.CacheKey key, PreparedStatement statement) Put a PreparedStatement in the cache.
Statement	registerUncachedStatement(Statement stmt) Register uncached statement so that it can be closed when the connection is put back in the pool.
boolean	release()
void	stateChanged(JdbcPooledConnection source, XAStatefulHolder.State oldState, XAStatefulHolder.State newState) Fired when the internal state of a XAStatefulHolder has changed.
void	stateChanging(JdbcPooledConnection source, XAStatefulHolder.State currentState, XAStatefulHolder.State futureState) Fired before the internal state of a XAStatefulHolder has changed.
String	toString()
void	unregisterUncachedStatement(Statement stmt)

Methods inherited from class bitronix.tm.resource.common.AbstractXAResourceHolder

acceptVisitorForXAResourceHolderStates, getXAResourceHolderStateCountForGtrid, getXAResourceHolderStateGtrids, getXAResourceHolderStatesForGtrid, hasStateForXAResource, isExistXAResourceHolderStatesForGtrid, isParticipatingInActiveGlobalTransaction, putXAResourceHolderState, removeXAResourceHolderState

Methods inherited from class bitronix.tm.resource.common.AbstractXAStatefulHolder

addStateChangeEventListener, getCreationDate, getState, removeStateChangeEventListener, setState

Methods inherited from class java.lang.Object

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

Methods inherited from interface bitronix.tm.resource.common.XAStatefulHolder

addStateChangeEventListener, getCreationDate, getState, removeStateChangeEventListener, setState

Constructor Detail

JdbcPooledConnection

public JdbcPooledConnection(PoolingDataSource poolingDataSource,
                            XAConnection xaConnection)
                     throws SQLException

Throws:

SQLException

Method Detail

close

public void close()
           throws SQLException

Description copied from interface: XAStatefulHolder

Close the physical connection that this XAStatefulHolder represents.

Specified by:

close in interface XAStatefulHolder<JdbcPooledConnection>

Throws:

SQLException

createRecoveryXAResourceHolder

public RecoveryXAResourceHolder createRecoveryXAResourceHolder()

release

public boolean release()
                throws SQLException

Throws:

SQLException

getXAResource

public XAResource getXAResource()

Description copied from interface: XAResourceHolder

Get the vendor's XAResource implementation of the wrapped resource.

Specified by:

getXAResource in interface XAResourceHolder<JdbcPooledConnection>

Returns:

the vendor's XAResource implementation.

getResourceBean

public ResourceBean getResourceBean()

Description copied from interface: XAResourceHolder

Get the ResourceBean which created this XAResourceHolder.

Specified by:

getResourceBean in interface XAResourceHolder<JdbcPooledConnection>

Returns:

the ResourceBean which created this XAResourceHolder.

getPoolingDataSource

public PoolingDataSource getPoolingDataSource()

getXAResourceHolders

public List<JdbcPooledConnection> getXAResourceHolders()

Description copied from interface: XAStatefulHolder

Get the list of XAResourceHolders created by this XAStatefulHolder that are still open.

This method is thread-safe.

Specified by:

getXAResourceHolders in interface XAStatefulHolder<JdbcPooledConnection>

Returns:

the list of XAResourceHolders created by this XAStatefulHolder that are still open.

getJdbcVersion

public int getJdbcVersion()

getConnectionHandle

public Object getConnectionHandle()
                           throws Exception

Description copied from interface: XAStatefulHolder

Create a disposable handler used to drive a pooled instance of XAStatefulHolder.

This method is thread-safe.

Specified by:

getConnectionHandle in interface XAStatefulHolder<JdbcPooledConnection>

Returns:

a resource-specific disposable connection object.

Throws:

Exception - a resource-specific exception thrown when the disposable connection cannot be created.

stateChanged

public void stateChanged(JdbcPooledConnection source,
                         XAStatefulHolder.State oldState,
                         XAStatefulHolder.State newState)

Description copied from interface: StateChangeListener

Fired when the internal state of a XAStatefulHolder has changed.

Specified by:

stateChanged in interface StateChangeListener<JdbcPooledConnection>

Parameters:

source - the XAStatefulHolder changing state.

oldState - the old state of the XAStatefulHolder.

newState - the new state of the XAStatefulHolder.

stateChanging

public void stateChanging(JdbcPooledConnection source,
                          XAStatefulHolder.State currentState,
                          XAStatefulHolder.State futureState)

Description copied from interface: StateChangeListener

Fired before the internal state of a XAStatefulHolder has changed.

Specified by:

stateChanging in interface StateChangeListener<JdbcPooledConnection>

Parameters:

source - the XAStatefulHolder changing state.

currentState - the current state of the XAStatefulHolder.

futureState - the future state of the XAStatefulHolder.

getCachedStatement

public PreparedStatement getCachedStatement(LruStatementCache.CacheKey key)

Get a PreparedStatement from cache.

Parameters:

key - the key that has been used to cache the statement.

Returns:

the cached statement corresponding to the key or null if no statement is cached under that key.

putCachedStatement

public PreparedStatement putCachedStatement(LruStatementCache.CacheKey key,
                                            PreparedStatement statement)

Put a PreparedStatement in the cache.

Parameters:

key - the statement's cache key.

statement - the statement to cache.

Returns:

the cached statement.

registerUncachedStatement

public Statement registerUncachedStatement(Statement stmt)

Register uncached statement so that it can be closed when the connection is put back in the pool.

Parameters:

stmt - the statement to register.

Returns:

the registered statement.

unregisterUncachedStatement

public void unregisterUncachedStatement(Statement stmt)

toString

public String toString()

Overrides:

toString in class Object

getStateDescription

public String getStateDescription()

Specified by:

getStateDescription in interface JdbcPooledConnectionMBean

getAcquisitionDate

public Date getAcquisitionDate()

Specified by:

getAcquisitionDate in interface JdbcPooledConnectionMBean

getLastReleaseDate

public Date getLastReleaseDate()

Description copied from interface: XAStatefulHolder

Get the date at which this object was last released to the pool. This is required to check if it is eligible for discard when the containing pool needs to shrink.

Specified by:

getLastReleaseDate in interface XAStatefulHolder<JdbcPooledConnection>

Returns:

the date at which this object was last released to the pool or null if it never left the pool.

getTransactionGtridsCurrentlyHoldingThis

public Collection<String> getTransactionGtridsCurrentlyHoldingThis()

Specified by:

getTransactionGtridsCurrentlyHoldingThis in interface JdbcPooledConnectionMBean