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, 74 insertions, 0 deletions

diff --git a/branches/sca-android/samples/binding-echo-extension/README b/branches/sca-android/samples/binding-echo-extension/README
new file mode 100644
index 0000000000..94716b151f
--- /dev/null
+++ b/branches/sca-android/samples/binding-echo-extension/README
@@ -0,0 +1,74 @@
+Binding Echo Sample
+===================
+This sample demonstrates how new bindings are constructed for Apache Tuscany 
+SCA. 
+
+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 want to try out the echo binding that this sample provides
+please see the binding-echo sample that provides the necessary client and
+application code to bring up an application that uses this binding
+
+Sample Overview
+---------------
+This sample contains a implementation of an SCA binding that simply echoes back 
+any messages that are sent to it. 
+
+binding-echo-extension/
+  src/
+    main/
+      java/
+        echo/                    - The binding interfaces
+          impl/                  - The bindings model classes
+          provider/              - The bindings runtime classes
+          server/                - A dummy server that the binding is plugged into
+      resources/
+        META-INF/
+          services/              - The extension declaration
+    test/
+      java/
+        echo/                    - test code
+      resources/
+        EchoBinding.composite    - the SCA assembly used by the unit test
+  build.xml                      - the Ant build file
+  pom.xml                        - the Maven build file
+  
+Building The Sample Using Ant
+-----------------------------
+With the binary distribution the sample can be built using Ant as 
+follows
+
+cd binding-echo-extension
+ant compile
+
+See the binding-echo sample to run a sample that uses this binding. 
+
+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 binding-echo-extension
+mvn
+
+Maven will also test that the sample extension built properly. You should see 
+the following output from the test phase.
+
+-------------------------------------------------------
+ T E S T S
+-------------------------------------------------------
+Running echo.EchoServiceTestCase
+Returned message: oof
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 1.011 sec
+Running echo.EchoReferenceTestCase
+Returned message: oof
+Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.06 sec
+
+Results :
+
+Tests run: 2, Failures: 0, Errors: 0, Skipped: 0 
+    
+
+This shows that the Junit test cases have run successfully.