Module jakarta.messaging

Package jakarta.jms

Interface XATopicSession

All Superinterfaces:

AutoCloseable, Runnable, Session, XASession

public interface XATopicSession
extends XASession

An XATopicSession provides a regular TopicSession. which can be used to create TopicSubscriber and TopicPublisher objects (optional).

The XATopicSession 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 using these XA interfaces directly.

Since:

JMS 1.0

Version:

Jakarta Messaging 2.0

See Also:

• XASession
• TopicSession

Field Summary

Fields inherited from interface jakarta.jms.Session

AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED

Method Summary

Modifier and Type	Method	Description
TopicSession	getTopicSession()	Gets the topic session associated with this XATopicSession.

Methods inherited from interface jakarta.jms.Session

close, createBrowser, createBrowser, createBytesMessage, createConsumer, createConsumer, createConsumer, createDurableConsumer, createDurableConsumer, createDurableSubscriber, createDurableSubscriber, createMapMessage, createMessage, createObjectMessage, createObjectMessage, createProducer, createQueue, createSharedConsumer, createSharedConsumer, createSharedDurableConsumer, createSharedDurableConsumer, createStreamMessage, createTemporaryQueue, createTemporaryTopic, createTextMessage, createTextMessage, createTopic, getAcknowledgeMode, getMessageListener, recover, run, setMessageListener, unsubscribe

Methods inherited from interface jakarta.jms.XASession

commit, getSession, getTransacted, getXAResource, rollback

Method Details

getTopicSession

TopicSession getTopicSession()
                      throws JMSException

Gets the topic session associated with this XATopicSession.

Returns:

the topic session object

Throws:

JMSException - if an internal error occurs.