WebLogic Server 6.0 Code Examples, BEA Systems, Inc.

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/examples/jms/queue directory. The script will perform the following step:

    Compile the queue example as shown in this example for Windows NT/2000:

      $ javac -d %CLIENT_CLASSES% *.java

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. Choose the server target for the exampleQueue connection factory as follows:
    1. Select the exampleQueue node. The exampleQueue connection factory configuration information displays in the right pane.
    2. Select the Targets tab in the right pane to display the Available and Chosen targets.
    3. Move the examplesServer target to the Chosen column and click the Apply button 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 (weblogic.system.ListenPort).
  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 (weblogic.system.ListenPort).
  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 (weblogic.system.ListenPort).
  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 (weblogic.system.ListenPort).
    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.


Documentation is available at
http://e-docs.bea.com/wls/docs60

Copyright © 2000 BEA Systems, Inc. All Rights Reserved.