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)
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 undefinedacknowledgeMode
- 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