O'Reilly - Java Message Service

A.2.6 QueueSender
Java Message Service
A QueueSender is created by a QueueSession, usually for a specific queue. Messages sent
by the QueueSender to a queue are delivered to a client connected to that queue. The
QueueSender is a subtype of the MessageProducer interface:
public interface QueueSender extends MessageProducer {
public Queue getQueue( ) throws JMSException;
public void send(Message message) throws JMSException;
public void send(Message message, int deliveryMode, int priority,
long timeToLive)
throws JMSException;
public void send(Queue queue, Message message) throws JMSException;
public void send(Queue queue, Message message,int deliveryMode,
int priority,long timeToLive)
throws JMSException;
}
A.2.7 QueueSession
The QueueSession is created by the QueueConnection. A QueueSession object is a factory
for creating Message, QueueSender, and QueueReceiver objects. A client can create multiple
QueueSession objects to provide more granular control over senders, receivers, and their
associated transactions. The QueueSession is a subtype of the Session interface:
public interface QueueSession extends Session {
public Queue createQueue(java.lang.String queueName)
throws JMSException;
public QueueReceiver createReceiver(Queue queue)
throws JMSException;
public QueueReceiver createReceiver(Queue queue, String messageSelector)
throws JMSException;
public QueueSender createSender(Queue queue) throws JMSException;
public QueueBrowser createBrowser(Queue queue) throws JMSException;
public QueueBrowser createBrowser(Queue queue, String messageSelector)
throws JMSException;
public TemporaryQueue createTemporaryQueue( ) throws JMSException;
}
A.2.8 TemporaryQueue
A TemporaryQueue is created by a QueueSession. A temporary queue is associated with the
connection that belongs to the QueueSession that created it. It is only active for the duration
of the session's connection, and is guaranteed to be unique across all connections. It lasts
only as long as its associated client connection is active. In all other respects, a temporary
queue is just like a "regular" queue. The TemporaryQueue is a subtype of the Queue
interface.
Since a temporary queue is created by a JMS client, it is unavailable to other JMS clients
unless the queue identity is transferred using the JMSReplyTo header. While any client may
send messages on another client's temporary queue, only the sessions that are associated
with the JMS client connection that created the temporary queue may receive messages
from it. JMS clients can also, of course, send messages to their own temporary queues:
public interface TemporaryQueue extends Queue {
public void delete( ) throws JMSException;
}
152