Package org.apache.commons.dbcp.managed
Class PoolableManagedConnectionFactory
java.lang.Object
org.apache.commons.dbcp.PoolableConnectionFactory
org.apache.commons.dbcp.managed.PoolableManagedConnectionFactory
- All Implemented Interfaces:
org.apache.commons.pool.PoolableObjectFactory
A
PoolableConnectionFactory
that creates PoolableManagedConnection
s.- Version:
- $Revision$ $Date$
-
Constructor Summary
ConstructorsConstructorDescriptionPoolableManagedConnectionFactory
(XAConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, boolean defaultReadOnly, boolean defaultAutoCommit) Create a PoolableManagedConnectionFactory and attach it to a connection pool.PoolableManagedConnectionFactory
(XAConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, int validationQueryTimeout, Collection connectionInitSqls, Boolean defaultReadOnly, boolean defaultAutoCommit, int defaultTransactionIsolation, String defaultCatalog, AbandonedConfig config) Create a PoolableManagedConnectionFactory and attach it to a connection pool. -
Method Summary
Modifier and TypeMethodDescriptionUses the configured XAConnectionFactory to create aPoolableManagedConnection
.Methods inherited from class org.apache.commons.dbcp.PoolableConnectionFactory
activateObject, destroyObject, getPool, passivateObject, setConnectionFactory, setConnectionInitSql, setDefaultAutoCommit, setDefaultCatalog, setDefaultReadOnly, setDefaultTransactionIsolation, setPool, setStatementPoolFactory, setValidationQuery, setValidationQueryTimeout, validateConnection, validateObject
-
Constructor Details
-
PoolableManagedConnectionFactory
public PoolableManagedConnectionFactory(XAConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, boolean defaultReadOnly, boolean defaultAutoCommit) Create a PoolableManagedConnectionFactory and attach it to a connection pool.- Parameters:
connFactory
- XAConnectionFactorypool
- connection poolstmtPoolFactory
- theKeyedObjectPoolFactory
to use to createKeyedObjectPool
s for poolingPreparedStatement
s, or null to disablePreparedStatement
poolingvalidationQuery
- a query to use tovalidate
Connection
s. Should return at least one row. Using null turns off validation.defaultReadOnly
- the default "read only" setting for borrowedConnection
sdefaultAutoCommit
- the default "auto commit" setting for returnedConnection
s
-
PoolableManagedConnectionFactory
public PoolableManagedConnectionFactory(XAConnectionFactory connFactory, org.apache.commons.pool.ObjectPool pool, org.apache.commons.pool.KeyedObjectPoolFactory stmtPoolFactory, String validationQuery, int validationQueryTimeout, Collection connectionInitSqls, Boolean defaultReadOnly, boolean defaultAutoCommit, int defaultTransactionIsolation, String defaultCatalog, AbandonedConfig config) Create a PoolableManagedConnectionFactory and attach it to a connection pool.- Parameters:
connFactory
- XAConnectionFactorypool
- connection poolstmtPoolFactory
- theKeyedObjectPoolFactory
to use to createKeyedObjectPool
s for poolingPreparedStatement
s, or null to disablePreparedStatement
poolingvalidationQuery
- a query to use tovalidate
Connection
s. Should return at least one row. Using null turns off validation.validationQueryTimeout
- the number of seconds that validation queries will wait for database response before failing. Use a value less than or equal to 0 for no timeout.connectionInitSqls
- a Collection of SQL statements to initializeConnection
s. Using null turns off initialization.defaultReadOnly
- the default "read only" setting for borrowedConnection
sdefaultAutoCommit
- the default "auto commit" setting for returnedConnection
sdefaultTransactionIsolation
- the default "Transaction Isolation" setting for returnedConnection
sdefaultCatalog
- the default "catalog" setting for returnedConnection
sconfig
- the AbandonedConfig if tracing SQL objects
-
-
Method Details
-
makeObject
Uses the configured XAConnectionFactory to create aPoolableManagedConnection
. ThrowsIllegalStateException
if the connection factory returns null. Also initializes the connection using configured initialization sql (if provided) and sets up a prepared statement pool associated with the PoolableManagedConnection if statement pooling is enabled.- Specified by:
makeObject
in interfaceorg.apache.commons.pool.PoolableObjectFactory
- Overrides:
makeObject
in classPoolableConnectionFactory
- Throws:
Exception
-