summaryrefslogtreecommitdiffstats
path: root/sca-java-1.x/trunk/samples/calculator-corba-service/README
diff options
context:
space:
mode:
Diffstat (limited to 'sca-java-1.x/trunk/samples/calculator-corba-service/README')
-rw-r--r--sca-java-1.x/trunk/samples/calculator-corba-service/README82
1 files changed, 82 insertions, 0 deletions
diff --git a/sca-java-1.x/trunk/samples/calculator-corba-service/README b/sca-java-1.x/trunk/samples/calculator-corba-service/README
new file mode 100644
index 0000000000..87863752cd
--- /dev/null
+++ b/sca-java-1.x/trunk/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.