javax.jms
Interface XAQueueConnectionFactory

All Superinterfaces:

ConnectionFactory, QueueConnectionFactory, XAConnectionFactory

All Known Implementing Classes:

JMQXAQueueConnectionFactory

public interface XAQueueConnectionFactory

extends XAConnectionFactory, QueueConnectionFactory

An XAQueueConnectionFactory provides the same create options as a QueueConnectionFactory (optional).

Version:

1.0 - 14 May 1998

Author:

Mark Hapner, Rich Burridge

See Also:

QueueConnectionFactory, XAConnectionFactory

Method Summary

XAQueueConnection	createXAQueueConnection() Creates an XA queue connection with the default user identity.
XAQueueConnection	createXAQueueConnection(String userName, String password) Creates an XA queue connection with the specified user identity.

Methods inherited from interface javax.jms.QueueConnectionFactory

createQueueConnection, createQueueConnection

Method Detail

createXAQueueConnection

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:

a newly created XA queue connection

Throws:

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.

createXAQueueConnection

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 - the caller's user name

password - the caller's password

Returns:

a newly created XA queue connection

Throws:

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.