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

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

Text description of the illustration adq14jpp4.gif

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 match certain criteria, the selector for the QueueBrowser can be any expression that has a combination of one or more of the following:

• JMSMessageID = 'ID:23452345' to retrieve messages that have a specified message ID

• JMS Message header fields or properties:

  JMSPriority < 3 AND JMSCorrelationID = 'Fiction'  
  
  

• User defined message properties:

  color IN ('RED', BLUE', 'GREEN') AND price < 30000 
  
  

All message IDs must be prefixed with "ID:"

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

Syntax

• Java (JDBC): Oracle9i 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'");