Top Description Methods
javax.jms

public Interface XATopicConnectionFactory

extends XAConnectionFactory, TopicConnectionFactory
An XATopicConnectionFactory provides the same create options as a TopicConnectionFactory (optional).

The XATopicConnectionFactory 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.

Since
JMS 1.0
Version
JMS 2.0
See Also
javax.jms.TopicConnectionFactory, javax.jms.XAConnectionFactory

Method Summary

Modifier and TypeMethod and Description
public XATopicConnection

Returns:

a newly created XA topic connection
createXATopicConnection()

Creates an XA topic connection with the default user identity.

public XATopicConnection

Returns:

a newly created XA topic connection
createXATopicConnection(String
the caller's user name
userName, String
the caller's password
password)

Creates an XA topic connection with the specified user identity.

Inherited from javax.jms.TopicConnectionFactory:
createTopicConnectioncreateTopicConnection
Inherited from javax.jms.XAConnectionFactory:
createXAConnectioncreateXAConnectioncreateXAContextcreateXAContext

Method Detail

createXATopicConnectionback to summary
public XATopicConnection createXATopicConnection() throws JMSException

Creates an XA topic connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Returns:XATopicConnection

a newly created XA topic connection

Exceptions
JMSException:
if the JMS provider fails to create an XA topic connection due to some internal error.
JMSSecurityException:
if client authentication fails due to an invalid user name or password.
createXATopicConnectionback to summary
public XATopicConnection createXATopicConnection(String userName, String password) throws JMSException

Creates an XA topic connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Parameters
userName:String

the caller's user name

password:String

the caller's password

Returns:XATopicConnection

a newly created XA topic connection

Exceptions
JMSException:
if the JMS provider fails to create an XA topic connection due to some internal error.
JMSSecurityException:
if client authentication fails due to an invalid user name or password.