javax.jms
Interface XAQueueConnection

All Superinterfaces:
Connection (src) , QueueConnection (src) , XAConnection (src)
All Known Implementing Classes:
JBossConnection (src) , SpyXAConnection (src)

public interface XAQueueConnection
extends XAConnection (src) , QueueConnection (src)

An XAQueueConnection provides the same create options as QueueConnection (optional). The only difference is that an XAConnection is by definition transacted.

The XAQueueConnection 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 Also:
XAConnection (src)

Method Summary
 QueueSession (src) createQueueSession(boolean transacted, int acknowledgeMode)
          Creates an XAQueueSession object.
 XAQueueSession (src) createXAQueueSession()
          Creates an XAQueueSession object.
 
Methods inherited from interface javax.jms.XAConnection (src)
createSession, createXASession
 
Methods inherited from interface javax.jms.Connection (src)
close, createConnectionConsumer, createDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop
 
Methods inherited from interface javax.jms.QueueConnection (src)
createConnectionConsumer
 

Method Detail

createXAQueueSession

public XAQueueSession (src)  createXAQueueSession()
                                    throws JMSException (src) 
Creates an XAQueueSession object.

Returns:
a newly created XAQueueSession
Throws:
JMSException (src) - if the XAQueueConnection object fails to create an XA queue session due to some internal error.

createQueueSession

public QueueSession (src)  createQueueSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException (src) 
Creates an XAQueueSession object.

Specified by:
createQueueSession in interface QueueConnection (src)
Parameters:
transacted - usage undefined
acknowledgeMode - usage undefined
Returns:
a newly created XAQueueSession
Throws:
JMSException (src) - if the XAQueueConnection object fails to create an XA queue session due to some internal error.
See Also:
Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, Session.DUPS_OK_ACKNOWLEDGE