XAConnectionFactory (Commons DBCP 1.4 API)

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

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`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
  - 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
```
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