svn commit: r1150290 - /tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README

[an...@apache.org]

Author: antelder
Date: Sun Jul 24 08:08:52 2011
New Revision: 1150290

URL: http://svn.apache.org/viewvc?rev=1150290&view=rev
Log:
Update sample README

Modified:
    tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README

Modified: tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README?rev=1150290&r1=1150289&r2=1150290&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/getting-started/helloworld-jsonrpc/README Sun Jul 24 08:08:52 2011
@@ -1,27 +1,27 @@
-Tuscany - Getting Started - Helloworld Sample
----------------------------------------------
+Tuscany - Getting Started - Helloworld JSONRPC Sample
+-----------------------------------------------------
 
-This sample demonstrates a simple helloworld style SCA application and how to run that with Tuscany.
+This sample extends the helloworld sample to make the helloworld service available as a JSON-RPC endpoint.
+JSON-RPC is a protocol for doing remote procedure calls encoded in JSON.
 
-See the README in the top-level samples folder for general information on the Tuscany samples.
+The changes to the helloworld sample are:
+- update the pom.xml with the additional dependencies
+- update the composite to use the JSON-RPC binding 
 
-This project creates an SCA contribution with a deployable composite named helloworld.composite.
-The composite defines an SCA component, HelloworldComponent, which provides a Helloworld service, 
-the component is implemented by a Java class. 
-
-You can use the contribution by starting the composite in the Tuscany Shell. To do that run the 
-following command in the helloworld folder:
+As with all the getting-started samples you can run this sample with:
 
    mvn tuscany:run 
 
-
+Then at a web browser enter the following URL:
+(JSON-RPC aruguments are base64 encoded, so in this URL "WyJXb3JsZCJd" unecoded is "["World"]")
 
    http://localhost:8080/HelloworldComponent/Helloworld?method=sayHello&params=WyJXb3JsZCJd&id=1
 
-
+which should return a page saying:
 
    {"id":1,"result":"Hello World"}
 
 
 
 
+