summaryrefslogtreecommitdiffstats
path: root/java/sca-contrib/samples/calculator-corba-reference/README
blob: 66c4cddb94fd983aa54bbd38bbb8bd9107122b96 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
Calculator CORBA Reference Sample
===============================

This sample illustrates the use of Tuscany CORBA Binding to call reference 
services that are hosted 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 wired 
connections with CORBA bindings. Instead of local add, subtract, multiply and 
divide components, an CORBA service implementation now provides the
add, subtract, multiply and divide interfaces and is hosted as an CORBA object. 
References specified in the .composite file include a CORBA binding which targets
this CORBA object. Name service which is used in CORBA communication is provided 
in test case class - CalculatorCORBAReferenceTestCase.java.

This sample adds a number of classes to the basic calculator sample:

calculator-corba-reference/
  src/
    main/
      java/
        calculator/
          CalculatorService.java  - as calculator sample
          AddService.java         - as calculator sample
          SubtractService.java    - as calculator sample
          MultipleService.java    - as calculator sample
          DivideService.java      - as calculator sample
          CalculatorClient.java   - as calculator sample
          CalculatorServiceImpl.java - calls the CORBA service
                                    that provides the target for the 
                                    CORBA bindings in the composite 
      resources/
        CalculatorCORBAReference.composite - the SCA assembly for this sample
    test/
      java/
        calculator/
          CalculatorCORBAReferenceTestCase.java - JUnit test case
          CalculatorCORBAServant.java - CORBA service implementation
          idl/                        - contains files generated 
                                        from  IDL file. Files are 
                                        used to create  CORBA object which
                                        will be consumed by SCA reference.
            _CalculatorCORBAServiceImplBase.java
            CalculatorCORBAService.java
            CalculatorCORBAServiceOperations.java
      resources/
        CalculatorCORBA.idl      - IDL description for CORBA object
  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-reference
mvn

You should see the following output from the test phase.

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running calculator.CalculatorCORBAReferenceTestCase
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 5.308 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

This shows that the Junit test cases have run successfully.