XAConnection.java |
/* * JBoss, the OpenSource EJB server * * Distributable under LGPL license. * See terms of license at gnu.org. */ package javax.jms; /** The <CODE>XAConnection</CODE> interface extends the capability of * <CODE>Connection</CODE> by providing an <CODE>XASession</CODE> (optional). * *<P>The <CODE>XAConnection</CODE> interface is optional. JMS providers * are not required to support this interface. This interface is for * use by JMS providers to support transactional environments. * Client programs are strongly encouraged to use the transactional support * available in their environment, rather than use these XA * interfaces directly. * * @see javax.jms.XAQueueConnection * @see javax.jms.XATopicConnection */ public interface XAConnection extends Connection{ /** Creates an <CODE>XASession</CODE> object. * * @return a newly created <CODE>XASession</CODE> * * @exception JMSException if the <CODE>XAConnection</CODE> object * fails to create an <CODE>XASession</CODE> due to * some internal error. * * @since 1.1 */ public XASession createXASession() throws JMSException; /** Creates an <CODE>Session</CODE> object. * * @param transacted usage undefined * @param acknowledgeMode usage undefined * * @return a <CODE>Session</CODE> object * * @exception JMSException if the <CODE>XAConnection</CODE> object * fails to create an <CODE>Session</CODE> due to * some internal error. * * @since 1.1 */ public Session createSession( boolean transacted, int acknowledgeMode ) throws JMSException; }
XAConnection.java |