XAConnection (Java 2 Platform SE 5.0) (original) (raw)


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 anXAConnection 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](../../java/sql/SQLException.html "class in java.sql") - if a database access error occurs



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, 2010 Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.