1 files changed, 82 insertions, 0 deletions
diff --git a/sca-java-1.x/branches/sca-java-1.5.1/samples/calculator-corba-service/README b/sca-java-1.x/branches/sca-java-1.5.1/samples/calculator-corba-service/README
new file mode 100644
index 0000000000..87863752cd
--- /dev/null
+++ b/sca-java-1.x/branches/sca-java-1.5.1/samples/calculator-corba-service/README
@@ -0,0 +1,82 @@
+Calculator CORBA Service Sample
+=============================
+
+This sample illustrates the use of Tuscany CORBA Binding to expose component 
+services as CORBA objects. It also demonstrates how a simple Java CORBA 
+Client application invokes the SCA Application's services exposed as CORBA 
+Services.
+
+The README in the samples directory (the directory above this) provides 
+general instructions about building and running samples. Take a look there 
+first. 
+
+
+Sample Overview
+---------------
+This sample extends the calculator sample by replacing the local service 
+binding with an CORBA binding. So a java client can call the service exposed
+by the SCA application using an CORBA client. Name service which is used in 
+CORBA communication is provided by Tuscany CORBA hosting module 
+(maven dependency: tuscany-host-corba-jse-tns) - see CORBA binding reference
+on Apache Tuscany website for details.
+
+This sample adds a number of classes to the basic calculator sample:
+
+calculator-corba-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
+      resources/
+        CalculatorCORBAServer.composite - the SCA assembly for this sample
+    test/
+      java/
+        calculator/
+          CalculatorCORBAServerTestCase.java          - JUnit test case
+          idl/                                        - contains files generated 
+                                                        from  IDL file. Files are 
+                                                        used to access SCA component.
+            CalculatorCORBAServiceHelper.java
+            CalculatorCORBAService.java
+            _CalculatorCORBAServiceStub.java
+            CalculatorCORBAServiceHolder.java
+            CalculatorCORBAServiceOperations.java
+      resources/
+        CalculatorCORBA.idl      - IDL description for SCA component
+  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 Maven 
+-------------------------------------------
+With either the binary or source distributions the sample can be built and run 
+using Maven as follows. 
+
+cd calculator-corba-service
+mvn
+
+You should see the following output from the test phase.
+
+-------------------------------------------------------
+ T E S T S
+-------------------------------------------------------
+Running calculator.CalculatorCORBAServerTestCase
+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.