Interface XAConnectionFactory

All Superinterfaces:
ConnectionFactory
All Known Implementing Classes:
DataSourceXAConnectionFactory, LocalXAConnectionFactory
public interface XAConnectionFactory extends ConnectionFactory
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 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

      Connection createConnection() throws SQLException
      Create a new Connection 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 interface ConnectionFactory
      Returns:
      a new Connection
      Throws:
      SQLException - if a database error occurs creating the connection