Package org.apache.commons.dbcp2.managed
Interface XAConnectionFactory
- All Superinterfaces:
ConnectionFactory
- All Known Implementing Classes:
DataSourceXAConnectionFactory
,LocalXAConnectionFactory
XAConnectionFactory is an extension of ConnectionFactory used to create connections
in a transaction managed environment. The XAConnectionFactory operates like a normal
ConnectionFactory except an TransactionRegistry is provided from which the XAResource
for a connection can be obtained. This allows the existing DBCP pool code to work with
XAConnections and gives a the ManagedConnection a way to enlist a connection in the
the transaction.
- Since:
- 2.0
- Version:
- $Id: XAConnectionFactory.java 1660791 2015-02-19 04:13:10Z psteitz $
- Author:
- Dain Sundstrom, Rodney Waldhoff
-
Method Summary
Modifier and TypeMethodDescriptionCreate a newConnection
in an implementation specific fashion.Gets the TransactionRegistry for this connection factory which contains a the XAResource for every connection created by this factory.
-
Method Details
-
getTransactionRegistry
TransactionRegistry getTransactionRegistry()Gets the TransactionRegistry for this connection factory which contains a the XAResource for every connection created by this factory.- Returns:
- the transaction registry for this connection factory
-
createConnection
Create a newConnection
in an implementation specific fashion.An implementation can assume that the caller of this will wrap the connection in a proxy that protects access to the setAutoCommit, commit and rollback when enrolled in a XA transaction.
- Specified by:
createConnection
in interfaceConnectionFactory
- Returns:
- a new
Connection
- Throws:
SQLException
- if a database error occurs creating the connection
-