Start branch for 1.3.1, the only changes in this commit are for the version

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

1 files changed, 147 insertions, 0 deletions

diff --git a/branches/sca-java-1.3.1/samples/calculator-rmi-service/README b/branches/sca-java-1.3.1/samples/calculator-rmi-service/README
new file mode 100644
index 0000000000..454cdc0d37
--- /dev/null
+++ b/branches/sca-java-1.3.1/samples/calculator-rmi-service/README
@@ -0,0 +1,147 @@
+Calculator RMI Service Sample
+=============================
+
+This sample illustrates the use of Tuscany RMI Binding to expose component 
+services as Java RMI Services. It also demonstrates how a simple Java RMI 
+Client application invokes the SCA Application's services exposed as RMI 
+Services.
+
+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 run
+
+OR if you don't have ant, on Windows do
+
+java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-rmi-service.jar calculator.CalculatorServer
+
+and on *nix do
+
+java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-rmi-service.jar calculator.CalculatorServer
+
+Now you have the server running you need to open another command prompt, navigate
+to the calculator-rmi-reference sample directory and do:
+
+ant run
+
+OR if you don't have ant, on Windows do
+
+java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-rmi-reference.jar calculator.CalculatorClient
+
+and on *nix do
+
+java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-rmi-reference.jar calculator.CalculatorClient
+
+
+Sample Overview
+---------------
+This sample extends the calculator sample by replacing the local service 
+binding with an RMI binding. SO a java client can call the service exposed
+by the SCA application using an RMI client.
+
+This sample adds a number of classes to the basic calculator sample:
+
+calculator-rmi-service/
+  src/
+    main/
+      java/
+        calculator/
+          CalculatorService.java  - as calculator sample
+          CalculatorServiceImpl.java
+          AddService.java         - as calculator sample
+          AddServiceImpl.java
+          SubtractService.java    - as calculator sample
+          SubtractServiceImpl.java
+          MultiplyService.java    - as calculator sample
+          MultiplyServiceImpl.java
+          DivideService.java      - as calculator sample
+          DivideServiceImpl.java
+          CalculatorClient.java   - (Not currently used) Uses the
+                                    java naming service to
+                                    look up the Calculator RMI service.
+                                    It then calls add, subtract, multiple
+                                    and divide methods on the service
+          CalculatorServer.java   - starts the SCA Runtime and deploys 
+                                    the CalculatorRMIServer.composite. 
+                                    In doing this the SCA RMI binding
+                                    acts to expose the CalculatorService
+                                    over RMI.
+      resources/
+        CalculatorRMIServer.composite - the SCA assembly for this sample
+    test/
+      java/
+        calculator/
+          CalculatorRMIServerTestCase.java - JUnit test case
+  calculator-rmi-service.png     - a pictorial representation of the 
+                                    .composite file
+  build.xml                       - the Ant build file for the server
+  pom.xml                         - the Maven build file   
+  
+Note. As this test creates and uses local network connections you may need to 
+configure your firewall, if you are running one, to allow the test to run
+successfully.         
+
+Building And Running The Sample Using Ant
+-----------------------------------------
+With the binary distribution the sample can be built and run using Ant. Two 
+build files are used to support client and server functions. 
+
+The server starts the SCA runtime and loads the SCA calculator application 
+which exposes an RMI service. Start a new console and use the following 
+commands.
+
+cd calculator-rmi-service
+ant compile
+ant run
+
+This will run up the server and display the following.
+
+run:
+     [java] Starting of the SCA Calculator Application exposed as RMI Services... 
+     [java] ...Press Enter to Exit...
+     
+The client is very similar to the calculator sample
+
+It locates the RMI service that the SCA runtime is exposing and calls each of 
+the calculator operations. Start a new console and use the following commands. 
+
+cd calculator-rmi-reference
+ant compile
+ant run
+
+You should see the following output from the run target.
+
+run:
+     [java] 3 + 2=5.0
+     [java] 3 - 2=1.0
+     [java] 3 * 2=6.0
+     [java] 3 / 2=1.5
+     
+If you now return to the console window running the server and press enter the 
+server should stop.     
+
+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. 
+
+cd calculator-rmi-service
+mvn
+
+You should see the following output from the test phase.
+
+-------------------------------------------------------
+ T E S T S
+-------------------------------------------------------
+Running calculator.CalculatorRMIServerTestCase
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 5.819 sec
+
+Results :
+
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
+
+This shows that the Junit test cases have run successfully.