JavaTM 2 Platform
Standard Ed. 5.0

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
 XAResource getXAResource()
          Retrieves an XAResource object that the transaction manager will use to manage this XAConnection object's participation in a distributed transaction.
 
Methods inherited from interface javax.sql.PooledConnection
addConnectionEventListener, close, getConnection, removeConnectionEventListener
 

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

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.