Pulled a recent revision of trunk into the sca-android branch, to apply the android patches from JIRA TUSCANY-2440 to it.

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

1 files changed, 151 insertions, 0 deletions

diff --git a/branches/sca-android/samples/helloworld-bpel-ws/README b/branches/sca-android/samples/helloworld-bpel-ws/README
new file mode 100644
index 0000000000..5c669f5da5
--- /dev/null
+++ b/branches/sca-android/samples/helloworld-bpel-ws/README
@@ -0,0 +1,151 @@
+Hello World BPEL Webservices Sample

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

+This sample demonstrates an SCA service implemented by a BPEL process, made available as a Web service. 

+

+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 compile run

+

+OR if you don't have ant, on Windows do

+

+mkdir target\classes

+mkdir target\wsdl2java-source

+java -cp ..\..\lib\tuscany-sca-manifest.jar org.apache.tuscany.sdo.generate.XSD2JavaGenerator -targetDirectory target/wsdl2java-source -prefix HelloWorld -noContainment -noUnsettable src/main/resources/helloworld.wsdl

+java -cp ..\..\lib\tuscany-sca-manifest.jar org.apache.tuscany.tools.wsdl2java.generate.WSDL2JavaGenerator -targetDirectory target/wsdl2java-source src/main/resources/helloworld.wsdl

+unzip ..\..\lib\ode-dao-jpa-ojpa-derby-1.1.zip -d target\database

+javac -d target\classes -cp target\classes;..\..\lib\tuscany-sca-manifest.jar -sourcepath src\main\java;target\wsdl2java-source -target 1.5 -g -source 1.5 src\main\java\helloworld\BPELClient.java

+copy src\main\resources\* target\classes

+java -cp ..\..\lib\tuscany-sca-manifest.jar;target\classes;target\database helloworld.BPELClient

+

+and on *nix do

+

+mkdir target/classes

+mkdir target/wsdl2java-source

+java -cp ../../lib/tuscany-sca-manifest.jar org.apache.tuscany.sdo.generate.XSD2JavaGenerator -targetDirectory target/wsdl2java-source -prefix HelloWorld -noContainment -noUnsettable src/main/resources/helloworld.wsdl

+java -cp ../../lib/tuscany-sca-manifest.jar org.apache.tuscany.tools.wsdl2java.generate.WSDL2JavaGenerator -targetDirectory target/wsdl2java-source src/main/resources/helloworld.wsdl

+unzip ../../lib/ode-dao-jpa-ojpa-derby-1.1.zip -d target/database

+javac -d target/classes -cp target/classes;../../lib/tuscany-sca-manifest.jar -sourcepath src/main/java;target/wsdl2java-source -target 1.5 -g -source 1.5 src/main/java/helloworld/BPELClient.java

+cp src/main/resources/* target/classes

+java -cp ../../lib/tuscany-sca-manifest.jar:target/classes:target/database helloworld.BPELClient

+

+The sample will start an embedded BPEL engine, deploy a process and invoke it.

+

+Sample Overview

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

+The sample provides a single component that is wired to a service with a 

+web service binding.

+

+helloworld-bpel/

+  src/

+    main/

+      java/

+        helloworld/

+          BPELClient.java          	  - client application for  

+                                            BEPELHelloWorldComponent

+

+      resources/

+          deploy.xml			  - ODE deployment descriptor

+          helloworld.bpel		  - helloworld bpel process

+          helloworld.componentType	  - helloworld bpel service description

+          helloworld.composite            - the SCA assembly for this sample

+          helloworld.wsdl                 - the service description that describes

+                                            the bpel process

+          log4j.properties                - logging configuration

+          

+    test/

+      java/

+        helloworld/

+          BPELHelloWorldTestCase.java     - JUnit test case 

+  helloworld-bpel.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 as 

+follows

+

+cd helloworld-bpel

+ant compile

+ant run

+

+     

+You should see the following output from the run target.     

+

+run:

+     [java] Starting BPELHelloWorldComponent

+     [java] >>> Deploying : D:\temp\SCA1.1-RC1\tuscany-sca-1.1-incubating\samples\helloworld-bpel\target\classes

+     [java] ::arg:::::: <?xml version="1.0" encoding="UTF-8"?>

+     [java] <hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl"><message xmlns="http://tuscany.apache.org/implementation/bpel/exampl

+e/helloworld.wsdl">Hello</message></hello>

+     [java] ::message:: <?xml version="1.0" encoding="UTF-8"?>

+     [java] <message><TestPart><hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl"><message xmlns="http://tuscany.apache.org/impleme

+ntation/bpel/example/helloworld.wsdl">Hello</message></hello></TestPart></message>

+     [java] Status: RESPONSE

+     [java] Response: <?xml version="1.0" encoding="UTF-8"?>

+     [java] <message><TestPart><hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl">Hello World</hello></TestPart></message>

+     [java] Hello World

+     [java] Stopping BPELHelloWorldComponent

+     [java] Stopped !!!

+

+BUILD SUCCESSFUL

+Total time: 36 seconds     

+

+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. When using Maven, a simple test is present that exercise

+the same logic as the client to invoke the BPEl process.

+

+cd helloworld-bpel

+mvn

+

+You should see the following output from the test phase.

+

+-

+

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

+ T E S T S

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

+Running helloworld.BPELHelloWorldTestCase

+Starting BPELHelloWorldComponent

+>>> Deploying : D:\dev\Opensource\Apache\Tuscany\source\java-sca-1.1\samples\helloworld-bpel\target\classes

+::arg:::::: <?xml version="1.0" encoding="UTF-8"?>

+<hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl"><message xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld

+.wsdl">Hello</message></hello>

+::message:: <?xml version="1.0" encoding="UTF-8"?>

+<message><TestPart><hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl"><message xmlns="http://tuscany.apache.org/implementation/bpel

+/example/helloworld.wsdl">Hello</message></hello></TestPart></message>

+Status: RESPONSE

+Response: <?xml version="1.0" encoding="UTF-8"?>

+<message><TestPart><hello xmlns="http://tuscany.apache.org/implementation/bpel/example/helloworld.wsdl">Hello World</hello></TestPart></message>

+Stopping BPELHelloWorldComponent

+Stopped !!!

+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 18.656 sec

+

+Results :

+

+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

+

+[INFO] [jar:jar]

+[INFO] Building jar: D:\dev\Opensource\Apache\Tuscany\source\java-sca-1.1\samples\helloworld-bpel\target\sample-helloworld-bpel.jar

+[INFO] [install:install]

+[INFO] Installing D:\dev\Opensource\Apache\Tuscany\source\java-sca-1.1\samples\helloworld-bpel\target\sample-helloworld-bpel.jar to C:\Documents and Settings\lresend

+e\.m2\repository\org\apache\tuscany\sca\sample-helloworld-bpel\1.1-incubating-SNAPSHOT\sample-helloworld-bpel-1.1-incubating-SNAPSHOT.jar

+[INFO] ------------------------------------------------------------------------

+[INFO] BUILD SUCCESSFUL

+[INFO] ------------------------------------------------------------------------

+[INFO] Total time: 53 seconds

+[INFO] Finished at: Sun Jan 13 09:54:39 PST 2008

+[INFO] Final Memory: 24M/43M

+[INFO] ------------------------------------------------------------------------

+

+

+This shows that the Junit test cases have run successfully.