Package examples.jms.queue

This example shows how to establish a connection to a JMS queue, and send, browse, and receive messages from that queue.

See:
Description

Class Summary

QueueBrowse	This example shows how to establish a connection to a JMS queue and browse (but not dequeue) the queued messages.
QueueReceive	This example shows how to establish a connection to and receive messages from a JMS queue.
QueueReceiveInTx	This example shows how to establish a connection to and receive messages from a JMS queue in a client-demarcated transaction.
QueueSend	This example shows how to establish a connection and send messages to the JMS queue.

Package examples.jms.queue Description

This example shows how to establish a connection to a JMS queue, and send, browse, and receive messages from that queue. The classes in this package operate on the same JMS queue. Run the classes together to observe messages being sent and received, and to browse the queue for messages.

The following sections describe how to:

1. Build the example
2. Configure the example
3. Run the example

Build the Example

1. Set up your development shell, as described in Setting up your environment.
2. Compile the example by executing the following command or by executing the build script provided for this example in the SAMPLES_HOME\server\src\ examples\jms\queue directory, where SAMPLES_HOME refers to the directory for all samples and examples for the WebLogic Platform.

The script will compile the Queue example, as shown in this example for a Windows systems:

  prompt> javac -d %CLIENT_CLASSES% *.java

and copies the files to the following directory:

SAMPLES_HOME\server\stage\examples\clientclasses\examples\jms\queue

Configure the Example

1. Start the server with the examples configuration.
2. Bring up the Administration Console in your browser.
3. Click to expand the JMS node in the left pane.
4. Click to expand the JMS Connection Factories node in the left pane.
5. Select the exampleQueue node. The exampleQueue connection factory configuration information displays in the right pane.
6. Select the Transactions tab in the right pane to display the transaction options.
7. Select the User Transactions Enabled check box.
8. Click Apply to save the change.
9. Choose the server target for the exampleQueue connection factory as follows:
   1. Select the Targets tab in the right pane to display the Available and Chosen targets.
   2. Move the examplesServer target to the Chosen column.
   3. Click Apply to save the assignment.
   Note: Normally, you would also have to choose one or more targets for the JMS server associated with the queue. For your convenience, the examplesJMSServer server has been preconfigured to include the examplesServer as a chosen target.

Run the Example

1. With the server running, set up a new development shell and run the QueueSend client with the following command:

     $ java examples.jms.queue.QueueSend t3://hostname:port

   where:

   hostname

   Host name of the WebLogic Server.

   port

   Port where the WebLogic Server is listening for connections.

2. Using the QueueSend client, send messages to the queue.

3. To browse messages in the queue, set up a new development shell and run the QueueBrowse client with the following command:

     $ java examples.jms.queue.QueueBrowse t3://hostname:port

   where:

   hostname

   Host name of the WebLogic Server.

   port

   Port where the WebLogic Server is listening for connections.

4. To receive messages from the queue, set up a new development shell and run the QueueReceive client with the following command:

     $ java examples.jms.queue.QueueReceive t3://hostname:port

   where:

   hostname

   Host name of the WebLogic Server.

   port

   Port where the WebLogic Server is listening for connections.

5. To receive messages from the queue in a client-demarcated transaction, set up a new development shell and run the QueueReceiveInTx client with the following command:

     $ java examples.jms.queue.QueueReceiveInTx t3://hostname:port

   where:

   hostname

   Host name of the WebLogic Server.

   port

   Port where the WebLogic Server is listening for connections.

   
   The program displays messages as they are received from the queue.

6. To end the program, send a quit message from the shell running the QueueSend client.

There's More...

For more information on WebLogic JMS, refer to Programming WebLogic JMS.