org.apache.commons.dbcp.managed
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 opperates 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.

Version:
$Revision$
Author:
Dain Sundstrom, Rodney Waldhoff

Method Summary
 java.sql.Connection createConnection()
          Create a new Connection in an implementation specific fashion.
 TransactionRegistry getTransactionRegistry()
          Gets the TransactionRegistry for this connection factory which contains a the XAResource for every connection created by this factory.
 

Method Detail

createConnection

java.sql.Connection createConnection()
                                     throws java.sql.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:
java.sql.SQLException - if a database error occurs creating the connection

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


Copyright © 2001-2004 Apache Software Foundation. Documenation generated February 2 2011.