diff options
author | lresende <lresende@13f79535-47bb-0310-9956-ffa450edef68> | 2008-09-11 04:10:13 +0000 |
---|---|---|
committer | lresende <lresende@13f79535-47bb-0310-9956-ffa450edef68> | 2008-09-11 04:10:13 +0000 |
commit | a72fcfa3adf5be93bcf62e8ed26c08d10939b364 (patch) | |
tree | ebe3e388f11a71335f38b120a11d83be3cbc95d7 /branches/trunk-20080910/samples/callbacks-jms/README | |
parent | 1ac507b3dc36ffa3340f66fe85cf626bfcf18831 (diff) |
Branch before trunk cleanup
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@694106 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to '')
-rw-r--r-- | branches/trunk-20080910/samples/callbacks-jms/README | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/branches/trunk-20080910/samples/callbacks-jms/README b/branches/trunk-20080910/samples/callbacks-jms/README new file mode 100644 index 0000000000..b5e130e2fc --- /dev/null +++ b/branches/trunk-20080910/samples/callbacks-jms/README @@ -0,0 +1,73 @@ +Callback JMS Sample
+===================
+This sample demonstrates SCA callbacks over the JMS binding. It implements the example
+described in the INFOQ article:
+
+ "Can I call you back about that?" Building Asynchronous Services using Service Component Architecture
+ See: http://www.infoq.com/articles/async-sca
+
+It implements a service for placing an order for some widgets, where the service is asynchronous
+and the client is informed of progress via a callback interface.
+
+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-callbacks-jms.jar callbacks.CallbacksTestCase
+
+and on *nix do
+
+java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-callbacks-jms.jar callbacks.CallbacksTestCase
+
+Sample Overview
+---------------
+
+The only changes over the sample code described in the INFOQ article are to add the @Remotable annotation
+to the service and callback interfaces, add the @Oneway annotation to the placeOrder and placeOrderResponse
+methods, and the composite XML is changed to use <binding.jms> instead of <binding.ws>.
+
+
+Building And Running The Sample Using Ant
+-----------------------------------------
+With the binary distribution the sample can be built and run using Ant as
+follows
+
+cd callbacks-jms
+ant compile
+ant run
+
+You should see the following output from the run target.
+
+run:
+ [java] client placing order: callbacks.OrderRequest@c72243
+ [java] service received order: callbacks.OrderRequest@1f94884
+ [java] client callback received order response: callbacks.OrderResponse@14ab51b
+
+Building And Running The Sample Using Maven
+-------------------------------------------
+With either the binary or source distributions the sample can be built and run
+using Maven as follows.
+
+cd callbacks-jms
+mvn
+
+You should see the following output from the test phase.
+
+-------------------------------------------------------
+ T E S T S
+-------------------------------------------------------
+Running callbacks.CallbacksTestCase
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.272 sec
+
+Results :
+
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
+
+This shows that the Junit test cases have run successfully.
|