XAConnection (Java SE 12 & JDK 12 )
Keywords: javax.sql.XAConnection interface

Module java.sql
Package javax.sql

## Interface XAConnection

- All Superinterfaces:
    `PooledConnection`

      public interface XAConnection
      extends PooledConnection

  An object that provides support for distributed transactions. An `XAConnection` object may be enlisted in a distributed transaction by means of an `XAResource` object. A transaction manager, usually part of a middle tier server, manages an `XAConnection` object through the `XAResource` object.

  An application programmer does not use this interface directly; rather, it is used by a transaction manager working in the middle tier server.

  Since:
    1.4

- - ### Method Summary

    Modifier and Type | Method | Description
    --- | --- | ---
    `XAResource` | `getXAResource()` | Retrieves an `XAResource` object that the transaction manager will use to manage this `XAConnection` object's participation in a distributed transaction.

    - ### Methods declared in interface javax.sql.PooledConnection

      `addConnectionEventListener, addStatementEventListener, close, getConnection, removeConnectionEventListener, removeStatementEventListener`

- - ### Method Detail

    - #### getXAResource

          XAResource getXAResource()
                            throws SQLException

      Retrieves an `XAResource` object that the transaction manager will use to manage this `XAConnection` object's participation in a distributed transaction.
      Returns:
        the `XAResource` object
      Throws:
        `SQLException` - if a database access error occurs
        `SQLFeatureNotSupportedException` - if the JDBC driver does not support this method
      Since:
        1.4