You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by ke...@apache.org on 2010/05/24 18:37:42 UTC

svn commit: r947708 - in /tuscany/sca-java-2.x/trunk/samples: binding-rmi/README calculator-osgi/README dosgi-calculator/README launcher-embedded-jse/README launcher-embedded-osgi/README

Author: kelvingoodson
Date: Mon May 24 16:37:41 2010
New Revision: 947708

URL: http://svn.apache.org/viewvc?rev=947708&view=rev
Log:
TUSCANY-3563 add readme to binding.rmi top level dir and fix launcher and osgi sample READMEs

Added:
    tuscany/sca-java-2.x/trunk/samples/binding-rmi/README
Modified:
    tuscany/sca-java-2.x/trunk/samples/calculator-osgi/README
    tuscany/sca-java-2.x/trunk/samples/dosgi-calculator/README
    tuscany/sca-java-2.x/trunk/samples/launcher-embedded-jse/README
    tuscany/sca-java-2.x/trunk/samples/launcher-embedded-osgi/README

Added: tuscany/sca-java-2.x/trunk/samples/binding-rmi/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/binding-rmi/README?rev=947708&view=auto
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/binding-rmi/README (added)
+++ tuscany/sca-java-2.x/trunk/samples/binding-rmi/README Mon May 24 16:37:41 2010
@@ -0,0 +1 @@
+Please look at the README files in the subdirectories of this directory for descriptions of the sample contributions.

Modified: tuscany/sca-java-2.x/trunk/samples/calculator-osgi/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/calculator-osgi/README?rev=947708&r1=947707&r2=947708&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/calculator-osgi/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/calculator-osgi/README Mon May 24 16:37:41 2010
@@ -1,97 +1,98 @@
-Calculator Sample
-=================
-This sample implements a simple calculator using SCA components and run it in a OSGi environment. 
-
-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 -jar ..\..\features\tuscany-sca-equinox-manifest.jar -composite Calculator.composite -config ..\..\features\configuration\ -ttl 0 target\sample-calculator-osgi.jar
-
-and on *nix do
-
-java -jar ../../features/tuscany-sca-equinox-manifest.jar -composite Calculator.composite -config ../../features/configuration/ -ttl 0 target/sample-calculator-osgi.jar
-
-Sample Overview
----------------
-The sample provides a single calculator service with a default SCA (java) 
-binding. The CalculatorClient exercises this interface by calling add, 
-subtract, multiply and divide operations. This results in messages passing to 
-the appropriate components in the composite across the local wires.
-
-calculator/
-  src/
-    main/
-      java/
-        calculator/
-          CalculatorService.java  - the first component, calls +-/* as 
-                                    appropriate
-          CalculatorServiceImpl.java
-          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
-          CalculatorClient.java   - starts the SCA Runtime and 
-                                    deploys the Calculator.composite. 
-                                    It then calls the deployed Calculator 
-                                    Components services
-      resources/
-        Calculator.composite      - the SCA assembly for this sample
-    test/
-      java/
-        calculator/
-          CalculatorTestCase.java - JUnit test case 
-  calculator.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 calculator
-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
-
-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
-mvn
-
-You should see the following output from the test phase.
-
--------------------------------------------------------
- T E S T S
--------------------------------------------------------
-Running calculator.CalculatorTestCase
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.272 sec
-
-Results :
-
-Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
-
-This shows that the Junit test cases have run successfully. 
+Calculator Sample
+=================
+This sample implements a simple calculator using SCA components and run it in a OSGi environment. 
+
+The README in the <distribution-unpack-dir>/samples directory provides 
+general instructions about building and running samples. (where
+distribution-unpack-dir is the directory in which you unpacked the tuscany
+binary distribution archive). Take a look there first, noting that this is not a new style sample. 
+
+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 -jar ..\..\features\tuscany-sca-equinox-manifest.jar -composite Calculator.composite -config ..\..\features\configuration\ -ttl 0 target\sample-calculator-osgi.jar
+
+and on *nix do
+
+java -jar ../../features/tuscany-sca-equinox-manifest.jar -composite Calculator.composite -config ../../features/configuration/ -ttl 0 target/sample-calculator-osgi.jar
+
+Sample Overview
+---------------
+The sample provides a single calculator service with a default SCA (java) 
+binding. The CalculatorClient exercises this interface by calling add, 
+subtract, multiply and divide operations. This results in messages passing to 
+the appropriate components in the composite across the local wires.
+
+calculator/
+  src/
+    main/
+      java/
+        calculator/
+          CalculatorService.java  - the first component, calls +-/* as 
+                                    appropriate
+          CalculatorServiceImpl.java
+          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
+          CalculatorClient.java   - starts the SCA Runtime and 
+                                    deploys the Calculator.composite. 
+                                    It then calls the deployed Calculator 
+                                    Components services
+      resources/
+        Calculator.composite      - the SCA assembly for this sample
+    test/
+      java/
+        calculator/
+          CalculatorTestCase.java - JUnit test case 
+  calculator.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 calculator
+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
+
+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
+mvn
+
+You should see the following output from the test phase.
+
+-------------------------------------------------------
+ T E S T S
+-------------------------------------------------------
+Running calculator.CalculatorTestCase
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.272 sec
+
+Results :
+
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
+
+This shows that the Junit test cases have run successfully. 

Modified: tuscany/sca-java-2.x/trunk/samples/dosgi-calculator/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/dosgi-calculator/README?rev=947708&r1=947707&r2=947708&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/dosgi-calculator/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/dosgi-calculator/README Mon May 24 16:37:41 2010
@@ -2,10 +2,12 @@ Distributed OSGi Calculator Sample
 ==================================
 This sample implements a distributed calculator using Distributed OSGi (RFC 119) over SCA.
 
-The README in the samples directory (the directory above this) provides
-general instructions about building and running samples. Take a look there
-first.
-
+The README in the <distribution-unpack-dir>/samples directory provides 
+general instructions about building and running samples. ( where
+distribution-unpack-dir is the directory in which you unpacked the tuscany
+binary distribution archive). Take a look there
+first, noting that this is not a new style sample.
+ 
 On Windows, run
 java -jar ..\..\modules\osgi-3.5.0-v20090520.jar -configuration ..\..\features\configuration -clean -console
 

Modified: tuscany/sca-java-2.x/trunk/samples/launcher-embedded-jse/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/launcher-embedded-jse/README?rev=947708&r1=947707&r2=947708&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/launcher-embedded-jse/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/launcher-embedded-jse/README Mon May 24 16:37:41 2010
@@ -8,3 +8,13 @@ The README file in the <distribution-unp
 general instructions about building and running sample contributions using the
 tuscany sample launchers ( where distribution-unpack-dir is the directory in which you
 unpacked the tuscany binary distribution archive)
+
+To use this sample JSE launcher with ant excute the command
+
+ant run-<contributionname>
+
+where run-<contributionname> is one of the targets in the build.xml file
+
+To use this sample launcher to run all of the contributions as junit test cases,
+execute the command "mvn" in the launcher directory.
+

Modified: tuscany/sca-java-2.x/trunk/samples/launcher-embedded-osgi/README
URL: http://svn.apache.org/viewvc/tuscany/sca-java-2.x/trunk/samples/launcher-embedded-osgi/README?rev=947708&r1=947707&r2=947708&view=diff
==============================================================================
--- tuscany/sca-java-2.x/trunk/samples/launcher-embedded-osgi/README (original)
+++ tuscany/sca-java-2.x/trunk/samples/launcher-embedded-osgi/README Mon May 24 16:37:41 2010
@@ -9,3 +9,12 @@ general instructions about building and 
 tuscany sample launchers. ( where
 distribution-unpack-dir is the directory in which you unpacked the tuscany
 binary distribution archive)
+
+To use this sample OSGI launcher with ant excute the command
+
+ant run-<contributionname>
+
+where run-<contributionname> is one of the targets in the build.xml file
+
+To use this sample launcher to run all of the contributions as junit test cases,
+execute the command "mvn" in the launcher directory.