1 /* 2 * @(#)XAConnection.java 1.8 03/12/19 3 * 4 * Copyright 2004 Sun Microsystems, Inc. All rights reserved. 5 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. 6 */ 7 8 package javax.sql; 9 10 import java.sql.*; 11 12 13 /** 14 * An object that provides support for distributed 15 * transactions. An <code>XAConnection</code> object may be enlisted 16 * in a distributed transaction by means of an <code>XAResource</code> object. 17 * A transaction manager, usually part of a middle tier server, manages an 18 * <code>XAConnection</code> object through the <code>XAResource</code> object. 19 * <P> 20 * An application programmer does not use this interface directly; rather, 21 * it is used by a transaction manager working in the middle tier server. 22 * 23 * @since 1.4 24 */ 25 26 public interface XAConnection extends PooledConnection { 27 28 29 /** 30 * Retrieves an <code>XAResource</code> object that 31 * the transaction manager will use 32 * to manage this <code>XAConnection</code> object's participation in a 33 * distributed transaction. 34 * 35 * @return the <code>XAResource</code> object 36 * @exception SQLException if a database access error occurs 37 */ 38 javax.transaction.xa.XAResource getXAResource() throws SQLException; 39 40 } 41 42 43 44 45 46