javax.jms
Interface XATopicConnection

All Superinterfaces:

Connection, TopicConnection, XAConnection

public interface XATopicConnection

extends XAConnection, TopicConnection

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

createXATopicSession

public javax.jms.XATopicSession createXATopicSession()
                                              throws JMSException

Creates an XATopicSession object.

Returns:

a newly created XA topic session

Throws:

JMSException - if the XATopicConnection object fails to create an XA topic session due to some internal error.

createTopicSession

public javax.jms.TopicSession createTopicSession(boolean transacted,
                                                 int acknowledgeMode)
                                          throws JMSException

Creates an XATopicSession object.

Specified by:

createTopicSession in interface TopicConnection

Parameters:

transacted - usage undefined

acknowledgeMode - usage undefined

Returns:

a newly created XA topic session

Throws:

JMSException - 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