Java Message Service, 2nd Edition

Point-to-Point API

This section covers the queue-based point-to-point interfaces and classes.

Queue

The Queue is an administered object that acts as a handle or identifier for an actual queue, called a physical queue , on the messaging server. A physical queue is a channel through which many clients can receive and send messages. The Queue is a subtype of the Destination interface.

Multiple receivers may connect to a queue, but each message in the queue may only be consumed by one of the queue’s receivers. Messages in the queue are ordered so that consumers receive messages in the order the message server placed them in the queue:

public interface Queue extends Destination {
    public String getQueueName() throws JMSException; 
    public String toString();
}

QueueBrowser

A QueueBrowser is a specialized object that allows you to peek ahead at pending messages on a Queue without actually consuming them. This feature is unique to point-to-point messaging. Queue browsing can be useful for monitoring the contents of a queue from an administration tool, or for browsing through multiple messages to locate a message that is more important than the one that is at the head of the queue:

public interface QueueBrowser {
    public Queue getQueue() throws JMSException;
    public String getMessageSelector() throws JMSException; 
    public Enumeration getEnumeration() throws JMSException; 
    public void close() throws JMSException;
}

QueueConnection

The QueueConnection is created by the QueueConnectionFactory. Each QueueConnection ...