javax.jms
Interface XATopicConnection

All Superinterfaces:

Connection, TopicConnection, XAConnection

All Known Subinterfaces:

JMQXATopicConnection

public interface XATopicConnection

extends XAConnection, TopicConnection

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

Version:

1.0 - 13 March 1998

Author:

Mark Hapner, Rich Burridge

See Also:

XAConnection

Method Summary

TopicSession	createTopicSession(boolean transacted, int acknowledgeMode) Creates an XATopicSession object.
XATopicSession	createXATopicSession() Creates an XATopicSession object.

Methods inherited from interface javax.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

Methods inherited from interface javax.jms.Connection

close, getClientID, getExceptionListener, getMetaData, setClientID, setExceptionListener, start, stop

Method Detail

createXATopicSession

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