Creating a Topic Browser for Topics with Text, Stream, Objects, Bytes or Map Messages

Figure 15-30 Use Case Diagram: Create a Topic Browser for Topics with Text, Stream, Objects, Bytes or Map Messages

Text description of the illustration adq15jps13.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 topic browser for topics with text, stream, objects, bytes, or map messages.

Usage Notes

To retrieve messages that have a certain correlationID, the selector for the TopicBrowser can be one 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 a list of messages.

Syntax

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

Example

Example 1

/* Create a browser without a selector */
TopicSession    jms_session;
TopicBrowser    browser;
Topic           topic;

browser = ((AQjmsSession) jms_session).createBrowser(topic, "SUBS1");

Example2

/* Create a browser for topics with a specified selector */
TopicSession    jms_session;
TopicBrowser    browser;
Topic           topic;

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