javax.jms
Interface QueueConnectionFactory

All Superinterfaces:

ConnectionFactory

All Known Subinterfaces:

XAQueueConnectionFactory

All Known Implementing Classes:

JMQQueueConnectionFactory, JMQXAQueueConnectionFactory

public interface QueueConnectionFactory

extends ConnectionFactory

A client uses a QueueConnectionFactory object to create QueueConnection objects with a point-to-point JMS provider.

Version:

1.0 - 14 May 1998

Author:

Mark Hapner, Rich Burridge

See Also:

ConnectionFactory

Method Summary

QueueConnection	createQueueConnection() Creates a queue connection with the default user identity.
QueueConnection	createQueueConnection(String userName, String password) Creates a queue connection with the specified user identity.

Method Detail

createQueueConnection

public QueueConnection createQueueConnection()
                                      throws JMSException

Creates a 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 queue connection

Throws:

JMSException - if the JMS provider fails to create the queue connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

createQueueConnection

public QueueConnection createQueueConnection(String userName,
                                             String password)
                                      throws JMSException

Creates a 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 queue connection

Throws:

JMSException - if the JMS provider fails to create the queue connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.