Copy 1.6 release to new 1.6.1 branch

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@988487 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 92 insertions, 0 deletions

diff --git a/sca-java-1.x/branches/sca-java-1.6.1/samples/helloworld-ws-sdo-webapp/README b/sca-java-1.x/branches/sca-java-1.6.1/samples/helloworld-ws-sdo-webapp/README
new file mode 100644
index 0000000000..aa4819927a
--- /dev/null
+++ b/sca-java-1.x/branches/sca-java-1.6.1/samples/helloworld-ws-sdo-webapp/README
@@ -0,0 +1,92 @@
+Hello World Web Service SDO WebApp Sample

+=========================================

+This sample demonstrates an SCA web service binding which works with

+SDO and runs as a web application.  

+

+The README in the samples directory (the directory above this) provides

+general instructions about building and running samples. Take a look there

+first.

+

+As this sample provides a web app there is a manual step where the WAR file

+that contains the sample is is built and copied to your web app container. 

+See the sections below for instructions on building the war.

+

+Once the web app is deployed use your browser to visit the following URL;

+

+   http://localhost:8080/sample-helloworld-ws-sdo-webapp

+

+The port and hostname will of course vary depending on your local installation.

+

+The resulting web page displayed should show:

+

+   Hello John Smith, Jane Doe!

+   

+Sample Overview

+---------------

+The sample builds a war with a single JSP (HelloWorld.jsp). This JSP 

+calls an SCA component with an SDO parameter. This in turn calls another

+SCA component with the SDO parameter. The contents of the SDO are then 

+returned as a simple string. This sample shows how SDO objects can 

+be passed into and between services in the context of a web application. 

+

+

+helloworld-jsonrpc-webapp/

+  src/

+    main/

+      java/

+        helloworld/ 

+          HelloWorld.java             - service interface

+          HelloWorldComponent.java    - first service implementation

+          HelloWorldmpl.java          - second service implementation

+      resources/

+        wsdl/

+          helloworld.wsdl             - the web services description

+          helloworld.xsd              - the SDO description

+        helloworldws.composite        - the SCA assembly for this sample

+      webapp

+        META-INF/

+          sca-contribution.xml        - specifies the composite to be deployed

+        WEB-INF/

+          web.xml                     - defines the listener that starts up the 

+                                        Tuscany SCA runtime

+        HelloWorld.jsp                - the web application that calls the 

+                                        SCA service passing in an SDO   

+           

+  helloworld-ws-sdo-webapp.png        - a pictorial representation of the 

+                                        sample .composite file

+  build.xml                           - the Ant build file 

+  pom.xml                             - the Maven build file     

+

+Building The Sample Using Ant

+-----------------------------------------

+With the binary distribution the sample can be built using Ant as 

+follows

+

+cd helloworld-ws-sdo-webapp

+ant package

+

+This should result in a war file (sample-helloworld-ws-sdo-webapp.war) in the target 

+directory. Copy this war file to your web app deployment directory in your

+web app container. 

+

+The process for getting the web app running will depend on which web app container

+you are using. For example, if you are using Tomcat then it is simply a matter

+of copying the WAR file to the webapps directory. 

+

+Once the web app is deployed use your browser to visit the following URL;

+

+http://localhost:8080/sample-helloworld-ws-sdo-webapp

+

+The port and hostname will of course vary depending on your local installation. 

+

+Building The Sample Using Maven

+-------------------------------

+With either the binary or source distributions the sample can be built and run

+using Maven as follows. When using Maven you don't need to run the helloworld-

+ws-service sample first as Maven does this for you.

+

+cd helloworld-ws-sdo-webapp

+mvn

+

+That should end with "BUILD SUCCESSFUL" and create the target/sample-helloworld-ws-sdo-webapp.war

+which you can copy to your server.