Package org.apache.tomcat.dbcp.dbcp2.managed

Class ManagedDataSource<C extends java.sql.Connection>

java.lang.Object

org.apache.tomcat.dbcp.dbcp2.PoolingDataSource<C>

org.apache.tomcat.dbcp.dbcp2.managed.ManagedDataSource<C>

Type Parameters:

C - The kind of Connection to manage.

public class ManagedDataSource<C extends java.sql.Connection>
extends PoolingDataSource<C>

The ManagedDataSource is a PoolingDataSource that creates ManagedConnections.

Since:

2.0

Constructor Summary

Constructors

Constructor	Description
ManagedDataSource(ObjectPool<C> pool, TransactionRegistry transactionRegistry)	Creates a ManagedDataSource which obtains connections from the specified pool and manages them using the specified transaction registry.

Method Summary

Modifier and Type	Method	Description
java.sql.Connection	getConnection()	Returns a Connection from my pool, according to the contract specified by ObjectPool.borrowObject().
void	setTransactionRegistry(TransactionRegistry transactionRegistry)	Sets the transaction registry from the XAConnectionFactory used to create the pool.

Methods inherited from interface javax.sql.CommonDataSource

createShardingKeyBuilder

Methods inherited from interface javax.sql.DataSource

createConnectionBuilder

Methods inherited from class java.lang.Object

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

Methods inherited from class org.apache.tomcat.dbcp.dbcp2.PoolingDataSource

close, getConnection, getLoginTimeout, getLogWriter, getParentLogger, getPool, isAccessToUnderlyingConnectionAllowed, isWrapperFor, setAccessToUnderlyingConnectionAllowed, setLoginTimeout, setLogWriter, unwrap

Constructor Detail

ManagedDataSource

public ManagedDataSource(ObjectPool<C> pool,
                         TransactionRegistry transactionRegistry)

Creates a ManagedDataSource which obtains connections from the specified pool and manages them using the specified transaction registry. The TransactionRegistry must be the transaction registry obtained from the XAConnectionFactory used to create the connection pool. If not, an error will occur when attempting to use the connection in a global transaction because the XAResource object associated with the connection will be unavailable.

Parameters:

pool - the connection pool

transactionRegistry - the transaction registry obtained from the XAConnectionFactory used to create the connection pool object factory

Method Detail

setTransactionRegistry

public void setTransactionRegistry(TransactionRegistry transactionRegistry)

Sets the transaction registry from the XAConnectionFactory used to create the pool. The transaction registry can only be set once using either a connector or this setter method.

Parameters:

transactionRegistry - the transaction registry acquired from the XAConnectionFactory used to create the pool

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Description copied from class: PoolingDataSource

Returns a Connection from my pool, according to the contract specified by ObjectPool.borrowObject().

Overrides:

getConnection in class PoolingDataSource<C extends java.sql.Connection>

Throws:

java.sql.SQLException