1. /*

  2.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  3.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  4.  */

  5. 

  6. package javax.jms;

  7. 

  8. /** The <CODE>XAConnectionFactory</CODE> interface is a base interface for the

  9.   * <CODE>XAQueueConnectionFactory</CODE> and 

  10.   * <CODE>XATopicConnectionFactory</CODE> interfaces.

  11.   *

  12.   * <P>Some application servers provide support for grouping JTS capable 

  13.   * resource use into a distributed transaction (optional). To include JMS API transactions 

  14.   * in a JTS transaction, an application server requires a JTS aware JMS

  15.   * provider. A JMS provider exposes its JTS support using an

  16.   * <CODE>XAConnectionFactory</CODE> object, which an application server uses 

  17.   * to create <CODE>XAConnection</CODE> objects.

  18.   *

  19.   * <P><CODE>XAConnectionFactory</CODE> objects are JMS administered objects, 

  20.   * just like <CODE>ConnectionFactory</CODE> objects. It is expected that 

  21.   * application servers will find them using the Java Naming and Directory

  22.   * Interface (JNDI) API.

  23.   *

  24.   * @version     1.0 - 14 May 1998

  25.   * @author      Mark Hapner

  26.   * @author      Rich Burridge

  27.   *

  28.   * @see         javax.jms.XAQueueConnectionFactory

  29.   * @see         javax.jms.XATopicConnectionFactory

  30.   */

  31. 

  32. public interface XAConnectionFactory {

  33. }