Hello World JMS Service Sample | |
============================== | |
This sample demonstrates an SCA service that uses a JMS binding | |
The README in the samples directory (the directory above this) provides | |
general instructions about building and running samples. Take a look there | |
first. | |
If you just want to run it to see what happens open a command prompt, navigate | |
to this sample directory and do: | |
ant run | |
OR if you don't have ant, on Windows do | |
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-helloworld-service-jms.jar helloworld.HelloWorldServer | |
and on *nix do | |
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-helloworld-service-jms.jar helloworld.HelloWorldServer | |
Now the server is started you can use the helloworld-reference-jms sample to | |
exercise it. | |
Sample Overview | |
--------------- | |
The sample provides a single component that is wired to a service with a | |
JMS binding. | |
helloworld-service-jms/ | |
src/ | |
main/ | |
java/ | |
helloworld/ | |
HelloWorldService.java - interface description for | |
HelloWorldServiceComponent | |
HelloWorldImpl.java - component implementation | |
HelloWorldServer.java - starts the SCA Runtime and | |
deploys the helloworldjmsservice | |
.composite and then waits for the | |
service to be called via JMS | |
resources/ | |
helloworldjmsservice.composite - the SCA assembly for this sample | |
test/ | |
java/ | |
helloworld/ | |
HelloWorldJMSServerTestCase.java- JUnit test case | |
helloworld-service.png - a pictorial representation of the | |
sample .composite file | |
build.xml - the Ant build file | |
pom.xml - the Maven build file | |
Building And Running The Sample Using Ant | |
----------------------------------------- | |
With the binary distribution the sample can be built and run using Ant using the | |
following commands | |
cd helloworld-service-jms | |
ant compile | |
ant run | |
You should see the following output from the run target. | |
run: | |
[java] log4j:WARN No appenders could be found for logger (org.apache.axiom. | |
om.util.StAXUtils). | |
[java] log4j:WARN Please initialize the log4j system properly. | |
[java] HelloWorld server started (press enter to shutdown) | |
As this point the SCA service is exposed as a JMS service via ActiveMQ which is | |
started automatically by the SCA runtime. To stop the server just press | |
enter. | |
To exercise the service run up the helloworld-reference-jms sample. Take a look at | |
the README in that sample and you will see you need the following commands | |
cd helloworld-reference-jms | |
ant run | |
Building Sample Using Maven | |
------------------------------------------- | |
With either the binary or source distributions the sample can be built | |
using Maven as follows. | |
cd helloworld-service-jms | |
mvn | |
You should see the following output | |
... | |
[INFO] ------------------------------------------------------------------------ | |
[INFO] BUILD SUCCESSFUL | |
[INFO] ------------------------------------------------------------------------ | |
[INFO] Total time: 15 seconds | |
[INFO] Finished at: Wed Jul 02 12:50:24 BST 2008 | |
[INFO] Final Memory: 13M/51M | |
[INFO] ------------------------------------------------------------------------ | |
This shows that the module has compiled successfully. |