Creating a branch for the equinox work.

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

1 files changed, 438 insertions, 0 deletions

diff --git a/branches/sca-equinox/samples/calculator-distributed/README b/branches/sca-equinox/samples/calculator-distributed/README
new file mode 100644
index 0000000000..51f4b07e81
--- /dev/null
+++ b/branches/sca-equinox/samples/calculator-distributed/README
@@ -0,0 +1,438 @@
+Calculator Distributed Sample

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

+This sample implements a simple calculator using SCA components.  It uses 

+exactly the same calculator application classes as the calculator sample but 

+runs the application distributed across three nodes.

+

+A node in this sample means an instance of the Tuscany SCA java runtime running

+in a Java virtual machine. 

+

+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 four command prompts and 

+navigate to this sample directory in each one. There is one command to be run 

+in each command prompt:

+

+ant runDomain

+ant runNodeB

+ant runNodeC

+ant runNodeA

+

+Please run the commands in this order. 

+

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

+

+java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchDomain

+java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeB

+java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeC

+java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeA

+

+and on *nix do

+

+java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchDomain

+java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchCalculatorNodeB

+java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchCalculatorNodeC

+java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchCalculatorNodeA

+

+

+The processes started on each of these command prompts can be ended by pressing 

+the <Enter> key.

+

+

+Sample Overview

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

+The sample provides a single calculator service with a default SCA (java) 

+binding. NodeA exercises this interface by calling add, subtract, multiply and 

+divide operations. 

+

+In the case of add and subtract the runtime recognises that

+it can't find these services locally and, using the remote (web services) 

+version of the default SCA binding, contacts the add service running in NodeB 

+and the subtract service running in NodeC. 

+

+On the command prompt where you started NodeA, you see the output of invoking the 

+calculator functions distributed over NodeB and and NodeC.  On the command prompts 

+where you have started NodeB and NodeC, you see log messages that indicate that

+the add and subtract services where called on these nodes respectively.

+

+The sample demonstrates that the calculator application can be distributed

+across multiple nodes with no change to the application or to the SCA description

+files. 

+

+The domain node makes available a web application through which the contributions and 

+composites used in this sample can be navigated. One you have run "ant runDomain" you can 

+point you browser at:

+

+http://localhost:9990/ui/workspace/

+

+The contents of the sample are as follows:

+

+calculator/

+  src/

+    main/

+      java/

+        calculator/

+          CalculatorService.java  - the first component, calls +-/* as 

+                                    appropriate

+          AddService.java         - adds two numbers

+          AddServiceImpl.java

+          SubtractService.java    - subtracts one number from another

+          SubtractServiceImpl.java

+          MultiplyService.java    - multiplies two numbers

+          MultiplyServiceImpl.java

+          DivideService.java      - divides one number by another

+          DivideServiceImpl.java

+        node/

+          LaunchCalculatorNodeA.java - runs an sca node configured with the 

+                                    composite describing the main calculator

+                                    application. If you look inside this class

+                                    you will see that the node is configured

+                                    using a URL of the form:

+                                    

+                                    http://localhost:9990/node-config/NodeA

+                                    

+                                    This retrieves the information required

+                                    to configure NodeA from the domain.

+

+                                    Once the node has been started this launcher

+                                    then finds the calculator service and 

+                                    calls the various methods.

+                                    

+          LaunchCalculatorNodeB&C.java -  These launchers start nodes B and C

+                                    which runs the add and subtract services.

+                                    

+                                    Unlike NodeA though these launchers just

+                                    wait once the node has been started. They

+                                    will service incomming web service requests

+                                    as they arrive.  

+

+           LaunchDomain.java      - the node that provides the domain 

+                                    configuration to the distributed

+                                    nodes

+      resources/

+        cloud                     - The SCA composite files that describe

+                                    the configuration of each node				

+        nodeA                     - the SCA assembly for nodeA's part of the 

+                                    calculator application

+        nodeB                     - the SCA assembly for nodeB's part of the 

+                                    calculator application

+        nodeC                     - the SCA assembly for nodeC's part of the 

+                                    calculator application

+    test/

+      java/

+        calculator/

+          CalculatorDistributedTestCase.java - JUnit test case which runs all 

+                                    of the separate nodes along with the domain

+                                    in a single VM for test purposes

+  calculator-distributed.png      - a pictorial representation of the sample 

+                                    .composite files

+  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 calculator-distributed

+ant compile

+ant runDomain

+ant runNodeB

+ant runNodeC

+ant runNodeA

+

+You should see the following output from the four separate command prompt:

+

+runDomain:

+ted>ant runDomain

+Buildfile: build.xml

+

+runDomain:

+     [java] 26-Mar-2008 12:55:12 org.apache.tuscany.sca.node.launcher.DomainMana

+gerLauncher main

+     [java] INFO: Apache Tuscany SCA Domain Manager starting...

+     [java] 26-Mar-2008 12:55:13 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 147 JARs from C:\simon\tuscany\sca-java-1.2

+\distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-

+1.2-incubating-SNAPSHOT\lib

+     [java] 26-Mar-2008 12:55:13 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 89 JARs from C:\simon\tuscany\sca-java-1.2\

+distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-1

+.2-incubating-SNAPSHOT\modules

+     [java] 26-Mar-2008 12:55:19 org.apache.catalina.core.StandardEngine start

+     [java] INFO: Starting Servlet Engine: Apache Tomcat/6.0.14

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.ContextConfig defau

+ltWebConfig

+     [java] INFO: No default web.xml

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/jsp_2_0.

+xsd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/jsp_2_1.

+xsd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jspt

+aglibrary_1_1.dtd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jspt

+aglibrary_1_2.dtd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jspt

+aglibrary_2_0.xsd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/jsp/resources/web-jspt

+aglibrary_2_1.xsd

+     [java] 26-Mar-2008 12:55:20 org.apache.catalina.startup.DigesterFactory reg

+ister

+     [java] WARNING: Could not get url for /javax/servlet/resources/j2ee_web_ser

+vices_1_1.xsd

+     [java] 26-Mar-2008 12:55:20 org.apache.coyote.http11.Http11Protocol init

+     [java] INFO: Initializing Coyote HTTP/1.1 on http-9990

+     [java] 26-Mar-2008 12:55:20 org.apache.coyote.http11.Http11Protocol start

+     [java] INFO: Starting Coyote HTTP/1.1 on http-9990

+     [java] 26-Mar-2008 12:55:20 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ui/home/*

+     [java] 26-Mar-2008 12:55:20 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ui/workspace/*

+     [java] 26-Mar-2008 12:55:20 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ui/files/*

+     [java] 26-Mar-2008 12:55:20 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ui/composite/*

+     [java] 26-Mar-2008 12:55:20 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ui/cloud/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/workspace/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/contribution/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/feed/files/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/files/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/composite/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/composite-source/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/deployable/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/composite-resolved/

+*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/cloud/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/cloud-source/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/composite-config/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/node-config/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/quickstart/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/processes/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/node/processes/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.http.tomcat.TomcatServer

+ addServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:9990/ping/*

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.node.launcher.DomainMana

+gerLauncher main

+     [java] INFO: SCA Domain Manager started.

+     [java] 26-Mar-2008 12:55:21 org.apache.tuscany.sca.node.launcher.DomainMana

+gerLauncher main

+     [java] INFO: Press enter to shutdown.

+

+

+runNodeB:

+     [java] 26-Mar-2008 12:55:42 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: Apache Tuscany SCA Node starting...

+     [java] 26-Mar-2008 12:55:42 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: SCA Node configuration: http://localhost:9990/node-config/NodeB

+

+     [java] 26-Mar-2008 12:55:42 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 147 JARs from C:\simon\tuscany\sca-java-1.2

+\distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-

+1.2-incubating-SNAPSHOT\lib

+     [java] 26-Mar-2008 12:55:42 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 89 JARs from C:\simon\tuscany\sca-java-1.2\

+distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-1

+.2-incubating-SNAPSHOT\modules

+     [java] 26-Mar-2008 12:55:42 org.apache.tuscany.sca.node.impl.NodeImpl <init

+>

+     [java] INFO: Creating node: http://localhost:9990/node-config/NodeB

+     [java] 26-Mar-2008 12:55:45 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading contribution: file:/C:/simon/tuscany/sca-java-1.2/dist

+ribution/target/apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir/tuscany-sca-1.2-i

+ncubating-SNAPSHOT/samples/calculator-distributed/./src/main/resources/nodeB/

+     [java] 26-Mar-2008 12:55:46 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading composite: http://localhost:9990/composite-resolved/co

+mposite:nodeB;http://sample;CalculatorB

+     [java] 26-Mar-2008 12:55:47 org.apache.tuscany.sca.node.impl.NodeImpl start

+

+     [java] INFO: Starting node: http://localhost:9990/node-config/NodeB

+     [java] Warning: Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor

+     [java] 26-Mar-2008 12:55:53 org.apache.tuscany.sca.http.jetty.JettyServer a

+ddServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:8200/AddServiceComponent

+B

+     [java] 26-Mar-2008 12:55:53 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: SCA Node started.

+     [java] 26-Mar-2008 12:55:53 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: Press enter to shutdown.

+     [java] AddService - add 3.0 and 2.0

+     

+runNodeC:

+     [java] 26-Mar-2008 12:56:01 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: Apache Tuscany SCA Node starting...

+     [java] 26-Mar-2008 12:56:01 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: SCA Node configuration: http://localhost:9990/node-config/NodeC

+

+     [java] 26-Mar-2008 12:56:01 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 147 JARs from C:\simon\tuscany\sca-java-1.2

+\distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-

+1.2-incubating-SNAPSHOT\lib

+     [java] 26-Mar-2008 12:56:01 org.apache.tuscany.sca.node.launcher.NodeLaunch

+erUtil collectJARFiles

+     [java] INFO: Runtime classpath: 89 JARs from C:\simon\tuscany\sca-java-1.2\

+distribution\target\apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir\tuscany-sca-1

+.2-incubating-SNAPSHOT\modules

+     [java] 26-Mar-2008 12:56:01 org.apache.tuscany.sca.node.impl.NodeImpl <init

+>

+     [java] INFO: Creating node: http://localhost:9990/node-config/NodeC

+     [java] 26-Mar-2008 12:56:03 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading contribution: file:/C:/simon/tuscany/sca-java-1.2/dist

+ribution/target/apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir/tuscany-sca-1.2-i

+ncubating-SNAPSHOT/samples/calculator-distributed/./src/main/resources/nodeC/

+     [java] 26-Mar-2008 12:56:04 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading composite: http://localhost:9990/composite-resolved/co

+mposite:nodeC;http://sample;CalculatorC

+     [java] 26-Mar-2008 12:56:04 org.apache.tuscany.sca.node.impl.NodeImpl start

+

+     [java] INFO: Starting node: http://localhost:9990/node-config/NodeC

+     [java] Warning: Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor

+     [java] 26-Mar-2008 12:56:10 org.apache.tuscany.sca.http.jetty.JettyServer a

+ddServletMapping

+     [java] INFO: Added Servlet mapping: http://L3AW203:8300/SubtractServiceComp

+onentC

+     [java] 26-Mar-2008 12:56:10 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: SCA Node started.

+     [java] 26-Mar-2008 12:56:10 org.apache.tuscany.sca.node.launcher.NodeLaunch

+er main

+     [java] INFO: Press enter to shutdown.

+     [java] SubtractService - subtract 3.0 and 2.0

+     

+runNodeA:

+     [java] 26-Mar-2008 12:56:10 org.apache.tuscany.sca.node.impl.NodeImpl <init

+>

+     [java] INFO: Creating node: http://localhost:9990/node-config/NodeA

+     [java] 26-Mar-2008 12:56:12 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading contribution: file:/C:/simon/tuscany/sca-java-1.2/dist

+ribution/target/apache-tuscany-sca-1.2-incubating-SNAPSHOT.dir/tuscany-sca-1.2-i

+ncubating-SNAPSHOT/samples/calculator-distributed/./src/main/resources/nodeA/

+     [java] 26-Mar-2008 12:56:13 org.apache.tuscany.sca.node.impl.NodeImpl confi

+gureNode

+     [java] INFO: Loading composite: http://localhost:9990/composite-resolved/co

+mposite:nodeA;http://sample;CalculatorA

+     [java] 26-Mar-2008 12:56:14 org.apache.tuscany.sca.assembly.builder.impl.Co

+mpositeBuilderImpl$1 problem

+     [java] WARNING: Component reference target not found, it might be a remote

+service: SubtractServiceComponentC

+     [java] 26-Mar-2008 12:56:14 org.apache.tuscany.sca.assembly.builder.impl.Co

+mpositeBuilderImpl$1 problem

+     [java] WARNING: Component reference target not found, it might be a remote

+service: AddServiceComponentB

+     [java] 26-Mar-2008 12:56:14 org.apache.tuscany.sca.node.impl.NodeImpl start

+

+     [java] INFO: Starting node: http://localhost:9990/node-config/NodeA

+     [java] Warning: Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor

+     [java] Warning: Running an XSLT 1.0 stylesheet with an XSLT 2.0 processor

+     [java] CalculatorService - add 3.0 and 2.0

+     [java] 3 + 2=5.0

+     [java] CalculatorService - subtract 3.0 and 2.0

+     [java] 3 - 2=1.0

+     [java] CalculatorService - multiply 3.0 and 2.0

+     [java] 3 * 2=6.0

+     [java] CalculatorService - divide 3.0 and 2.0

+     [java] 3 / 2=1.5

+     [java] 26-Mar-2008 12:56:20 org.apache.tuscany.sca.node.impl.NodeImpl stop

+     [java] INFO: Stopping node: http://localhost:9990/node-config/NodeA

+

+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 running from Maven the four nodes all run within 

+Java virtual machine. 

+

+cd calculator-distributed

+mvn

+

+You should see the following output at the end of the test phase.

+

+INFO: Starting node: http://localhost:9990/node-config/NodeA

+CalculatorService - add 3.0 and 2.0

+AddService - add 3.0 and 2.0

+CalculatorService - subtract 3.0 and 2.0

+SubtractService - subtract 3.0 and 2.0

+CalculatorService - multiply 3.0 and 2.0

+CalculatorService - divide 3.0 and 2.0

+26-Mar-2008 13:00:52 org.apache.tuscany.sca.node.impl.NodeImpl stop

+INFO: Stopping node: http://localhost:9990/node-config/NodeC

+26-Mar-2008 13:00:52 org.apache.tuscany.sca.node.impl.NodeImpl stop

+INFO: Stopping node: http://localhost:9990/node-config/NodeB

+26-Mar-2008 13:00:52 org.apache.tuscany.sca.node.impl.NodeImpl stop

+INFO: Stopping node: http://localhost:9990/node-config/NodeA

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

+

+Results :

+

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

+

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

+

+

+