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 ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchDomain
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeB
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeC
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.LaunchCalculatorNodeA

and on *nix do

java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchDomain
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchCalculatorNodeB
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.LaunchCalculatorNodeC
java -cp ../../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 typing 'q'.


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/
        workspace.xml             - The domain manager configuration files that
        domain.composite            describe the configuration of the domain's
        cloud.composite             contributions, composites, and nodes

        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.