Top Description Methods
javax.jms

public Interface XAQueueConnectionFactory

extends XAConnectionFactory, QueueConnectionFactory
An XAQueueConnectionFactory provides the same create options as a QueueConnectionFactory (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.QueueConnectionFactory, javax.jms.XAConnectionFactory

Method Summary

Modifier and TypeMethod and Description
public XAQueueConnection

Returns:

a newly created XA queue connection
createXAQueueConnection()

Creates an XA queue connection with the default user identity.

public XAQueueConnection

Returns:

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

Creates an XA queue connection with the specified user identity.

Inherited from javax.jms.QueueConnectionFactory:
createQueueConnectioncreateQueueConnection
Inherited from javax.jms.XAConnectionFactory:
createXAConnectioncreateXAConnectioncreateXAContextcreateXAContext

Method Detail

createXAQueueConnectionback to summary
public XAQueueConnection createXAQueueConnection() throws JMSException

Creates an XA queue 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:XAQueueConnection

a newly created XA queue connection

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

Creates an XA queue 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:XAQueueConnection

a newly created XA queue connection

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