Module jakarta.messaging

Package jakarta.jms

Interface XATopicConnection

All Superinterfaces:

AutoCloseable, 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. Jakarta Messaging providers are not required to support this interface. This interface is for use by Jakarta Messaging 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.

Since:

JMS 1.0

Version:

Jakarta Messaging 2.0

See Also:

• XAConnection

Method Summary

Modifier and Type	Method	Description
TopicSession	createTopicSession(boolean transacted, int acknowledgeMode)	Creates a TopicSession object.
XATopicSession	createXATopicSession()	Creates an XATopicSession object.

Methods inherited from interface jakarta.jms.Connection

close, createConnectionConsumer, createSession, createSession, createSharedConnectionConsumer, createSharedDurableConnectionConsumer, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Methods inherited from interface jakarta.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

Methods inherited from interface jakarta.jms.XAConnection

createSession, createXASession

Method Details

createXATopicSession

XATopicSession createXATopicSession()
                             throws JMSException

Creates an XATopicSession object.

Returns:

a newly created XATopicSession

Throws:

JMSException - if the XATopicConnection object fails to create an XATopicSession due to some internal error.

createTopicSession

TopicSession createTopicSession(boolean transacted,
 int acknowledgeMode)
                         throws JMSException

Creates a TopicSession object.

Specified by:

createTopicSession in interface TopicConnection

Parameters:

transacted - usage undefined

acknowledgeMode - usage undefined

Returns:

a newly created TopicSession

Throws:

JMSException - if the XATopicConnection object fails to create a TopicSession due to some internal error.

See Also:

• Session.AUTO_ACKNOWLEDGE
• Session.CLIENT_ACKNOWLEDGE
• Session.DUPS_OK_ACKNOWLEDGE