Creating a Queue Receiver for Queues of Standard JMS Type Messages

Figure 14-19 Use Case Diagram: Create a Queue Receiver for Queues of Standard JMS Type Messages

Text description of the illustration adq14jpp11.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 receiver for queues of standard JMS type messages.

Usage Notes

The selector for the QueueReceiver 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:"

Syntax

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

Example

Example1

/* Create a receiver without a selector */
QueueSession    jms_session
QueueReceiver   receiver;
Queue           queue;

receiver = jms_session.createReceiver(queue);

Example2

/* Create a receiver for queues with a specified selector */
QueueSession    jms_session;
QueueReceiver   receiver;
Queue           queue;

/* create a Receiver to receive messages with correlationID starting with EXP  
*/
browser = jms_session.createReceiver(queue, "JMSCorrelationID LIKE 'EXP%'");