javax.jms
Interface XATopicConnection

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

public interface XATopicConnection
extends XAConnection (src) , TopicConnection (src)

An XATopicConnection provides the same create options as TopicConnection (optional). The Topic connections created are transactional.

The XATopicConnection 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
 TopicSession (src) createTopicSession(boolean transacted, int acknowledgeMode)
          Creates an XATopicSession object.
 XATopicSession (src) createXATopicSession()
          Creates an XATopicSession 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.TopicConnection (src)
createConnectionConsumer, createDurableConnectionConsumer
 

Method Detail

createXATopicSession

public XATopicSession (src)  createXATopicSession()
                                    throws JMSException (src) 
Creates an XATopicSession object.

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

createTopicSession

public TopicSession (src)  createTopicSession(boolean transacted,
                                       int acknowledgeMode)
                                throws JMSException (src) 
Creates an XATopicSession object.

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