Package jakarta.jms

Interface QueueConnectionFactory

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
See Also:
  • Method Details

    • 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.