QueueConnectionFactory (Jakarta Messaging API documentation)

All Superinterfaces:

ConnectionFactory

All Known Subinterfaces:

XAQueueConnectionFactory
```
public interface QueueConnectionFactory
extends ConnectionFactory
```
A client uses a QueueConnectionFactory object to create QueueConnection objects with a point-to-point Jakarta Messaging 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.

Since:

JMS 1.0

Version:

Jakarta Messaging 2.0

See Also:

ConnectionFactory

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`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.

Methods inherited from interface jakarta.jms.ConnectionFactory
createConnection, createConnection, createContext, createContext, createContext, createContext

- Method Detail
  - createQueueConnection
```
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 Jakarta Messaging 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
```
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 Jakarta Messaging 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.