javax.jms
Interface QueueConnectionFactory

All Superinterfaces:

ConnectionFactory (src)

All Known Subinterfaces:

JmsConnectionFactory (src) , XAQueueConnectionFactory (src)

All Known Implementing Classes:

JBossConnectionFactory (src) , JmsConnectionFactoryImpl (src) , SpyConnectionFactory (src) , SpyXAConnectionFactory (src)

public interface QueueConnectionFactory

extends ConnectionFactory (src)

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

QueueConnectionFactory can be used to create a QueueConnection, from which specialized queue-related objects can be created. A more general, and recommended, approach is to use the ConnectionFactory object.

The QueueConnectionFactory object can be used to support existing code that already uses it.

See Also:

ConnectionFactory (src)

createQueueConnection

public QueueConnection (src)  createQueueConnection()
                                      throws JMSException (src) 

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 (src) - if the JMS provider fails to create the queue connection due to some internal error.

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

createQueueConnection

public QueueConnection (src)  createQueueConnection(java.lang.String userName,
                                             java.lang.String password)
                                      throws JMSException (src) 

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 (src) - if the JMS provider fails to create the queue connection due to some internal error.

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