XATopicConnection (Java 2 Platform Ent. Ed. v1.4) - Java Platform, Enterprise Edition v1.4 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Ent. Ed. v1.4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

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.

Version:: 1.1 - February 2, 2002
Author:: Mark Hapner, Rich Burridge, Kate Stout
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.XAConnection

createSession, createXASession

Methods inherited from interface javax.jms.Connection

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

Methods inherited from interface javax.jms.TopicConnection

createConnectionConsumer, createDurableConnectionConsumer

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