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
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
|
Calculator Distributed Sample
=============================
This sample implements a simple calculator using SCA components. It uses
exactly the same calculator application classes as the calculator sample but
runs the application distributed across three nodes.
A node in this sample means an instance of the Tuscany SCA java runtime running
in a Java virtual machine.
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 four command prompts and
navigate to this sample directory in each one. There is one command to be run
in each command prompt:
ant runDomainNode
ant runNodeB
ant runNodeC
ant runNodeA
Please run the commands in this order.
OR if you don't have ant, on Windows use
java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.DomainNode
java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.CalculatorNode mydomain nodeB
java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.CalculatorNode mydomain nodeC
java -cp src\main\resources;..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-distributed.jar node.CalculatorNode mydomain nodeA
and on *nix do
java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.DomainNode
java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.CalculatorNode mydomain nodeB
java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.CalculatorNode mydomain nodeC
java -cp src/main/resources:../../lib/tuscany-sca-manifest.jar:target/sample-calculator-distributed.jar node.CalculatorNode mydomain nodeA
The processes started on each of these command prompts can be ended by pressing
the <Enter> key.
Sample Overview
---------------
The sample provides a single calculator service with a default SCA (java)
binding. NodeA exercises this interface by calling add, subtract, multiply and
divide operations.
In the case of add and subtract the runtime recognises that
it can't find these services locally and, using the remote (web services)
version of the default SCA binding contacts the add service running in NodeB
and the subtract service running in NodeC.
On the command prompt where you started NodeA, you would see output of invoking the
calculator functions distributed over NodeB and and NodeC. On the command prompts
where you have started NodeB and NodeC, you would see log messages that indicate that
the add and substract services where called on these nodes respectively.
The sample demonstrates that the calculator application can be distributed
across multiple nodes with no change to the application or to the SCA description
files.
calculator/
src/
main/
java/
calculator/
CalculatorService.java - the first component, calls +-/* as
appropriate
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
node/
CalculatorNode.java - runs up an sca application based on
configuration given on the command
line in the form
CalculatorNode <domain name> <node name>
it looks for a directory name the same
as <node name> and loads the composites
there
if <node name> = nodeA it calls the
+-/* operations otherwise it behaves
like a server and waits for service
requests
DomainNode.java - the node that provides the service
discovery mechanism to the distributed
domain
resources/
domain - the SCA assembly for the service discovery
function
management/ - the SCA assembly for each nodes management
function
nodeA - the SCA assembly for nodeA's part of the
calculator application
nodeB - the SCA assembly for nodeB's part of the
calculator application
nodeC - the SCA assembly for nodeB's part of the
calculator application
test/
java/
calculator/
DomainInMemoryTestCase.java - JUnit test case which runs all of the
separate ndes in a single VM for test
purposes
calculator-distributed.png - a pictorial representation of the sample
.composite files
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-distributed
ant compile
ant runDomainNode
ant runNodeB
ant runNodeC
ant runNodeA
You should see the following output from the four separate command prompt:
runDomainNode:
[java] log4j:WARN No appenders could be found for logger (org.apache.axiom.
om.util.StAXUtils).
[java] log4j:WARN Please initialize the log4j system properly.
[java] 23-Aug-2007 17:40:40 org.apache.tuscany.sca.http.jetty.JettyServer a
ddServletMapping
[java] INFO: Added Servlet mapping: http://localhost:8080/ServiceDiscoveryC
omponent/ServiceDiscovery
[java] Domain node started (press enter to shutdown)
[java] Registering service: [mydomain nodeB AddServiceComponent org.apache.
tuscany.sca.assembly.SCABinding http://localhost:8085/AddServiceComponent]
[java] Registering service: [mydomain nodeC SubtractServiceComponent org.ap
ache.tuscany.sca.assembly.SCABinding http://localhost:8086/SubtractServiceCompon
ent]
[java] Finding service: [mydomain SubtractServiceComponent org.apache.tusca
ny.sca.assembly.SCABinding]
[java] Matching service url: http://localhost:8086/SubtractServiceComponent
[java] Finding service: [mydomain AddServiceComponent org.apache.tuscany.sc
a.assembly.SCABinding]
[java] Matching service url: http://localhost:8085/AddServiceComponent
[java] Java Result: 1
Terminate batch job (Y/N)? y
runNodeB:
[java] file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/
target/classes/management/
[java] log4j:WARN No appenders could be found for logger (org.apache.axiom.
om.util.StAXUtils).
[java] log4j:WARN Please initialize the log4j system properly.
[java] Registering service: [mydomain nodeB AddServiceComponent/ org.apache
.tuscany.sca.assembly.SCABinding http://localhost:8085/AddServiceComponent]
[java] 23-Aug-2007 17:41:25 org.apache.tuscany.sca.http.jetty.JettyServer a
ddServletMapping
[java] INFO: Added Servlet mapping: http://localhost:8085/AddServiceCompone
nt
[java] Node started (press enter to shutdown)
[java] AddService - add 3.0 and 2.0
runNodeC:
[java] file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/
target/classes/management/
[java] log4j:WARN No appenders could be found for logger (org.apache.axiom.
om.util.StAXUtils).
[java] log4j:WARN Please initialize the log4j system properly.
[java] Registering service: [mydomain nodeC SubtractServiceComponent org.ap
ache.tuscany.sca.assembly.SCABinding http://localhost:8086/SubtractServiceCompon
ent]
[java] 23-Aug-2007 17:41:51 org.apache.tuscany.sca.http.jetty.JettyServer a
ddServletMapping
[java] Node started (press enter to shutdown)
[java] INFO: Added Servlet mapping: http://localhost:8086/SubtractServiceCo
mponent
[java] SubtractService - subtract 3.0 and 2.0
Terminate batch job (Y/N)? y
runNodeA:
[java] file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/
target/classes/management/
[java] log4j:WARN No appenders could be found for logger (org.apache.axiom.
om.util.StAXUtils).
[java] log4j:WARN Please initialize the log4j system properly.
[java] 23-Aug-2007 17:42:12 org.apache.tuscany.sca.assembly.builder.impl.Co
mpositeBuilderImpl$1 problem
[java] WARNING: [WARNING] Component reference target not found, it might be
a remote service: AddServiceComponent null
[java]
[java] 23-Aug-2007 17:42:12 org.apache.tuscany.sca.assembly.builder.impl.Co
mpositeBuilderImpl$1 problem
[java] WARNING: [WARNING] Component reference target not found, it might be
a remote service: SubtractServiceComponent null
[java]
[java] Finding service: [mydomain SubtractServiceComponent org.apache.tusca
ny.sca.assembly.SCABinding]
[java] Finding service: [mydomain AddServiceComponent org.apache.tuscany.sc
a.assembly.SCABinding]
[java] CalculatorService - add 3.0 and 2.0
[java] 3 + 2=5.0
[java] CalculatorService - subtract 3.0 and 2.0
[java] 3 - 2=1.0
[java] CalculatorService - multiply 3.0 and 2.0
[java] 3 * 2=6.0
[java] CalculatorService - divide 3.0 and 2.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. When running from Maven the four nodes all run within
Java virtual machine.
cd calculator-distributed
mvn
You should see the following output from the test phase.
-------------------------------------------------------
T E S T S
-------------------------------------------------------
Running calculator.DomainInMemoryTestCase
Setting up distributed nodes
file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/target/class
es/management/
log4j:WARN No appenders could be found for logger (org.apache.axiom.om.util.StAX
Utils).
log4j:WARN Please initialize the log4j system properly.
23-Aug-2007 18:18:41 org.apache.tuscany.sca.assembly.builder.impl.CompositeBuild
erImpl$1 problem
WARNING: [WARNING] Component reference target not found, it might be a remote se
rvice: AddServiceComponent null
23-Aug-2007 18:18:41 org.apache.tuscany.sca.assembly.builder.impl.CompositeBuild
erImpl$1 problem
WARNING: [WARNING] Component reference target not found, it might be a remote se
rvice: SubtractServiceComponent null
file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/target/class
es/management/
Registering service: [mydomain nodeB AddServiceComponent org.apache.tuscany.sca.
assembly.SCABinding http://localhost:8085/AddServiceComponent]
file:/C:/simon/tuscany/java-head/sca/samples/calculator-distributed/target/class
es/management/
Registering service: [mydomain nodeC SubtractServiceComponent org.apache.tuscany
.sca.assembly.SCABinding http://localhost:8086/SubtractServiceComponent]
Finding service: [mydomain SubtractServiceComponent org.apache.tuscany.sca.assem
bly.SCABinding]
Matching service url: http://localhost:8086/SubtractServiceComponent
Finding service: [mydomain AddServiceComponent org.apache.tuscany.sca.assembly.S
CABinding]
Matching service url: http://localhost:8085/AddServiceComponent
23-Aug-2007 18:18:45 org.apache.tuscany.sca.http.jetty.JettyServer addServletMap
ping
INFO: Added Servlet mapping: http://localhost:8085/AddServiceComponent
23-Aug-2007 18:18:47 org.apache.tuscany.sca.http.jetty.JettyServer addServletMap
ping
INFO: Added Servlet mapping: http://localhost:8086/SubtractServiceComponent
CalculatorService - add 3.0 and 2.0
AddService - add 3.0 and 2.0
CalculatorService - subtract 3.0 and 2.0
SubtractService - subtract 3.0 and 2.0
CalculatorService - multiply 3.0 and 2.0
CalculatorService - divide 3.0 and 2.0
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 7.14 sec
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
This shows that the Junit test cases have run successfully.
Known Bug :
---------
The processes that are running NodeB and NodeC do not seem to end on pressing the
<Enter>. This will be fixed for the next release. For this release you should use
^C (Control C) to exit these processes.
|
