XAConnectionFactory (Apache Commons DBCP 2.2.0 API)

Prev Class
Next Class

All Classes

Summary:
Nested |
Field |
Constr |
Method

Detail:
Field |
Constr |
Method

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 a 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

Author:

Dain Sundstrom, Rodney Waldhoff

Method Summary

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

Prev Class
Next Class

All Classes

Summary:
Nested |
Field |
Constr |
Method

Detail:
Field |
Constr |
Method

Copyright © 2001–2017 The Apache Software Foundation. All rights reserved.