javax.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 JMS provider.
QueueConnectionFactory
can be used to create a
QueueConnection<.CODE>, 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
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(java.lang.String userName,
java.lang.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 namepassword
- 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.