JBoss Messaging Topic Example

$Revision: 82920 $

Overview


This example creates a JMS Connection to a JBoss Messaging instance and uses it to create a session, a publisher and a subscriber. The publisher sends a message to the topic. The example is considered successful if the topic subscriber receives the message.

This example relies on having access to a running JBoss default instance. However, the example will automatically deploy its own topic, unless a topic with the same name is already deployed.


Running the example

1. Set up the JBOSS_HOME environment variable to point to the JBoss instance you deployed JBoss Messaging into. For example, if you deployed JBoss Messaging in C:\jboss-5.0.0.GA\server\default\deploy, then your JBOSS_HOME value should be C:\jboss-5.0.0.GA.

2. Go to the example's home directory

cd ...\examples\topic

3. Run the example:

ant


The output of a successful run should be similar to:


$ ant
Buildfile: build.xml

identify:
     [echo] XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     [echo] X                       Running the TOPIC example                         X
     [echo] XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
     [echo] The topic: testTopic

sanity-check:

init:
    [mkdir] Created dir: C:\work\src\cvs\jboss-head\jms\docs\examples\topic\output
    [mkdir] Created dir: C:\work\src\cvs\jboss-head\jms\docs\examples\common\output

compile:
    [javac] Compiling 2 source files to C:\work\src\cvs\jboss-head\jms\docs\examples\common\output
    [javac] Compiling 2 source files to C:\work\src\cvs\jboss-head\jms\docs\examples\topic\output

run:
     [java] Topic /topic/testTopic exists
     [java] The message was successfully published on the topic
     [java] Received message: Hello!
     [java] The example connected to JBoss Messaging version 1.4.1.GA (1.4)

     [java] #####################
     [java] ###    SUCCESS!   ###
     [java] #####################

BUILD SUCCESSFUL
Total time: 4 seconds





Troublesooting

1. I get "javax.jms.JMSSecurityException: User null is NOT authenticated"

You probably didn't install JBoss Messaging correctly. A fresh JBoss Messaging installation requires changes in the security configuration of a default JBoss instance, specifically a properly configured "messaging" security domain.  Follow the instructions from the "Installation" paragraph of the release documentation.