Create a Queue Browser for Queues with Text, Stream, Objects, Bytes or Map Messages

Figure 14-12 Use Case Diagram: Create a Queue Browser for Queues with Text, Stream, Objects, Bytes or Map Messages

To refer to the table of all basic operations having to do with the Operational Interface see: "Use Case Model: Operational Interface -- Basic Operations"

Purpose

Create a queue browser for queues with text, stream, objects, bytes or map messages.

Usage Notes

To retrieve messages that have a certain correlationID, the selector for the QueueBrowser can be one of the following:

• JMSMessageID = 'ID:2345234523452345' to retrieve messages that have the specified message ID.

• JMSCorrelationID = 'RUSH'

• JMSCorrelationID LIKE 'RE%'

All message IDs must be prefixed with "ID:"

Use methods in java.util.Enumeration to go through list of messages.

Syntax

• Java (JDBC): Oracle8i Supplied Java Packages Reference, oracle.jms, AQjmsSession.createBrowser

Example

Example1

/* Create a browser without a selector */
QueueSession    jms_session;
QueueBrowser    browser;
Queue           queue;

browser = jms_session.createBrowser(queue);

Example2

/* Create a browser for queues with a specified selector */
QueueSession    jms_session;
QueueBrowser    browser;
Queue           queue;

/* create a Browser to look at messages with correlationID = RUSH  */
browser = jms_session.createBrowser(queue, "JMSCorrelationID = 'RUSH'");