Package examples.jms.topic

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

See:
Description

Class Summary

TopicReceive	This example shows how to establish a connection to and receive messages from a JMS topic.
TopicSend	This examples shows how to establish a connection and send messages to the JMS topic.

Package examples.jms.topic Description

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

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\topic directory, where SAMPLES_HOME refers to the directory for all samples and examples for the WebLogic Platform.

The script will compile the Topic 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\topic

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 exampleTopic connection factory as follows:
1. Select the exampleTopic node. The exampleTopic 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 topic. 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 TopicReceive client with the following command:

  prompt> java examples.jms.topic.TopicReceive t3://hostname:port

where:

hostname

Host name of the WebLogic Server.

port

Port where the WebLogic Server is listening for connections.

2. To observe messages being sent to mutliple topic subscribers, set up a new development shell and run the TopicReceive client, as described in the previous step.
3. To send messages to the topic, set up a new development shell and run the TopicSend client with the following command:

  prompt> java examples.jms.topic.TopicSend t3://hostname:port

where:

hostname

Host name of the WebLogic Server.

port

Port where the WebLogic Server is listening for connections.

4. To end the program, send a quit message from the shell running the TopicSend client.

There's More...

For more information, refer to Programming WebLogic JMS.