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
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--
Copyright 1999-2004 The Apache Software Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<!-- Content Stylesheet for Site -->
<!-- start the processing -->
<!-- ====================================================================== -->
<!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
<!-- Main Page Section -->
<!-- ====================================================================== -->
<html>
<head>
<link rel="stylesheet" href="./css/style.css"/>
<script src="DropMenu.js" type="text/javascript"></script>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
<title>Tuscany - Tuscany</title>
</head>
<body topmargin="0" leftmargin="0" marginwidth="0" marginheight="0">
<table class="topbar" id="topbar" border="0" width="100%" cellspacing="0" cellpadding="0" height="94" background="images/TopBarBG.png">
<tr>
<td width="244">
<img src="images/Logo.png" width="244" height="94" alt=""></td>
<td align="right">
<img src="http://incubator.apache.org/tuscany/images/apache-incubator-logo.png" style="padding: 5px;"> </td>
</tr>
</table>
<table border="0" width="100%" cellspacing="4">
<tr>
<!-- LEFT SIDE NAVIGATION -->
<td width="141" valign="top" nowrap="true" >
<table width="100%" class="navbar" border="0" cellpadding="0" cellspacing="0" align="center" height="100%" >
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Tuscany General
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./index.html">Home</a>
<br>
<a href="./news.html">News</a>
<br>
<a href="./documentation.html">Documentation</a>
<br>
<a href="./Releases.html">Releases</a>
<br>
<a href="./getting_started.html">Getting Started</a>
<br>
<a href="./license.html">License</a>
<br>
<a href="http://www.apache.org/" target="_blank">ASF</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Tuscany SCA
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./sca_index.html">SCA Overview</a>
<br>
<a href="./java_sca_overview.html">SCA Java</a>
<br>
<a href="./cpp_sca_overview.html">SCA C++</a>
<br>
<a href="./sca_documentation.html">SCA Docs.</a>
<br>
<a href="./sca_downloads.html">SCA Downloads</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Tuscany SDO
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./sdo_index.html">SDO Overview</a>
<br>
<a href="./java_sdo_overview.html">SDO Java</a>
<br>
<a href="./cpp_sdo_overview.html">SDO C++</a>
<br>
<a href="./sdo_documentation.html">SDO Docs.</a>
<br>
<a href="./sdo_downloads.html">SDO Downloads</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Tuscany DAS
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./das_index.html">DAS Overview</a>
<br>
<a href="./java_das_overview.html">DAS Java</a>
<br>
<a href="./das_documentation.html">DAS Docs.</a>
<br>
<a href="./das_downloads.html">DAS Downloads</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Community
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./get-involved.html">Get Involved</a>
<br>
<a href="./mail-lists.html">Mailing Lists</a>
<br>
<a href="./faq.html">FAQ</a>
<br>
<a href="./issue-tracking.html">Issue Tracking</a>
<br>
<a href="http://wiki.apache.org/ws/Tuscany" target="_blank">Wiki</a>
<br>
<a href="http://apache-tuscany.blogspot.com" target="_blank">Blog</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
<tr class="navbarHead">
<td>
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="137">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
Development
</td>
<td width="8" height="4"background="images/NavBarRS.png" ></td>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
<td width="6"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" >
<tr>
<td background="images/leftSideGreyBorder.png" width="6" ></td>
<td bgcolor="#fafafa" width="124">
<a href="./source-code.html">Source Code</a>
<br>
<a href="./java-projects.html">Tuscany Java</a>
<br>
<a href="./cpp-projects.html">Tuscany C++</a>
<br>
<a href="./site_development.html">Tuscany WebSite</a>
<br>
</td>
<td background="images/rightSideGreyBorder.png" width="7"></td>
</tr>
</table>
</td>
</tr>
<tr>
<td><img src="images/greyBottom.png" width="137" height="10" alt=""></td>
</tr>
</table>
</td>
<!-- CONTENT! -->
<td width="100%" align="left" valign="top">
<table class="content" border="0" width="98%" cellspacing="0" cellpadding="0" align="left">
<tr>
<td>
<table class="content" border="0" width="100%" cellspacing="0" cellpadding="0" align="left">
<tr class="title" height="17" >
<td>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
<a name="Tuscany Service Component Architecture - Java">Tuscany Service Component Architecture - Java</a>
</td>
<td width="8" height="4" background="images/NavBarRS.png" ></td>
</tr>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tbody>
<tr>
<td background="images/ContentBoxLS.png" width="8"></td>
<td align="left">
<p> Tuscany SCA Java provides an implementation for the SCA
specifications made available at <a href="http://www.osoa.org/display/Main/Service+Component+Architecture+Home" target="_blank">Open SOA</a>.
This Java implementation provides an SCA runtime that is
itself built as an assembly of SCA components. It is modularized into a core and a set of SPIs that provides the flexibility of varying parts or whole of the runtime implementation.<br />
<br />
Tuscany SCA Java provides a number of useful extensions (implementation type containers and transport / protocol extension bindings) that can be used to quickly assemble solutions around components implemented over different technologies. Here is a diagram showing the extensions available with SCA Java.<br /></p>
<div align="center">
<img src="./images/sca_java_overview_2.png" alt="Tuscany Overview" usemap="#tuscany_overview" border="0" />
</div>
</td>
<td width="8" height="4" background="images/ContentBoxRS.png" >
</td>
</tr>
<tr>
<td align="right" valign="bottom"><img src= "images/ContentBoxBL.png"></td>
<td background="images/ContentBoxB.png"></td>
<td align="left"><img src="images/ContentBoxBR.png"></td>
</tr>
</tbody>
</table>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td>
<table class="content" border="0" width="100%" cellspacing="0" cellpadding="0" align="left">
<tr class="title" height="17" >
<td>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tbody>
<tr>
<td align="right" width="8" height="4"><img src= "images/NavBarTL.png"></td>
<td height="4" background="images/NavBarT.png"></td>
<td align="left"><img src="images/NavBarTR.png"></td>
</tr>
<tr>
<td background="images/NavBarLS.png" width="8"></td>
<td align="center" background="images/NavBarM.png">
<a name="SCA Java Overview">SCA Java Overview</a>
</td>
<td width="8" height="4" background="images/NavBarRS.png" ></td>
</tr>
<tr>
<td align="right" valign="top"><img src= "images/NavBarBL.png"></td>
<td background="images/NavBarB.png"></td>
<td align="left"><img src="images/NavBarBR.png"></td>
</tr>
</tbody>
</table>
</td>
</tr>
<tr>
<td>
<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tbody>
<tr>
<td background="images/ContentBoxLS.png" width="8"></td>
<td align="left">
<p>You will find information here on how to download Tuscany SCA Java, install it, build and run the samples, and develop Tuscany SCA Java applications.</p>
<h3>Downloading the Release Files</h3>
<p>See <a href="sca_downloads.html" title="SCA Downloads">SCA Downloads</a> for links to the downloadable archives for Tuscany SCA Java.
<i>Note: These archives all unpack into the current directory.</i></p>
<h3>Installing the Binary Distribution</h3>
<p>If you would like to run from a pre-built binary distribution, proceed as follows:</p>
<ol>
<li>Download the binary distribution tuscany-sca-1.0-incubator-M2-bin.tar.gz or tuscany-sca-1.0-incubator-M2-bin.zip.</li>
<li>Create an empty directory and unpack the binary distribution into that directory.</li>
<li>In later sections of this document, we will refer to the directory that was created in step 2 (or built from source following the alternative instructions above) as (sca-home).</li>
</ol>
<h3>Building the Source Distribution</h3>
<p>If you prefer to build the Tuscany SCA Java implementation from the source distribution, the procedure is as follows:</p>
<ol>
<li>Download the implementation source distribution tuscany-sca-1.0-incubator-M2-src.tar.gz or tuscany-sca-1.0-incubator-M2-src.zip.</li>
<li>Create an empty directory and unpack the source distribution into that directory.</li>
<li>Follow the instructions in the BUILDING.txt file that was unpacked.</li>
</ol>
<p>As part of the above build process, the SCA and commonj specification files will be downloaded as pre-built binaries from the remote maven repositories into your local maven repository.</p>
<p>Alternatively, you can build these specification binaries from source and install them in your local maven repository, as follows:</p>
<ol>
<li>Download the SCA specification source distribution tuscany-spec-sca-r0.95-incubator-M2-src.tar.gz or tuscany-spec-sca-r0.95-incubator-M2-src.zip.</li>
<li>Create a new empty directory and unpack the source distribution into that directory.</li>
<li>Change directory to the newly created directory and run "mvn install". The SCA specification binary jar will be installed in your local maven repository.</li>
<li>Download the commonj specification source distribution tuscany-spec-commonj-1.1-incubator-M2-src.tar.gz or tuscany-spec-commonj-1.1-incubator-M2-src.zip.</li>
<li>Create a new empty directory and unpack the source distribution into that directory.</li>
<li>Change directory to the newly created directory and run "mvn install". The commonj specification binary jar will be installed in your local maven repository.</li>
</ol>
<h3>Checking Out and Building the Source</h3>
<p>If you want to do a development build from the latest Tuscany SCA Java source tree in the subversion repository, you will need to check out and build the code. You'll need Subversion and Maven installed on your machine. For details of where to obtain these, see the <a href="java-projects.html" title="Java project page">Java project page</a>. The following instructions are correct at the time of writing, but may change in the near future because of build restructuring.</p>
<p><i>Note: Maven automatically downloads project dependencies from remote repositories, so a live internet connection is required the first time a build is run. Because of load on the repository servers, you may experience occasional download failures. If these should occur, simply rerun the build.</i></p>
<ol>
<li>Before building Tuscany SCA Java, you will previously need to have built Tuscany SDO Java. The SDO Java build installs the SDO jars in your local Maven repository (located by default in ${user.home}/.m2/repository ) from where they will be picked up when building the Tuscany SCA implementation. See <a href="java_sdo_overview.html" title="SDO Java">SDO Java</a> for details of how to do this.</li>
<li>Create an empty directory and cd to that directory.</li>
<li>Check out the SCA specifications Java source by running the command
<p style="font-family:monospace">�svn co http://svn.apache.org/repos/asf/incubator/tuscany/java/spec/sca/ spec/sca</p></li>
<li>cd to the spec/sca subdirectory and run "mvn" from this directory. This will install the SCA specifications jar in your local Maven repository from where it will be picked up when building the Tuscany SCA implementation.</li>
<li>cd back to the directory you created and check out the commonj specifications Java source by running the command
<p style="font-family:monospace">�svn co http://svn.apache.org/repos/asf/incubator/tuscany/java/spec/commonj/ spec/commonj</p></li>
<li>cd to the spec/commonj subdirectory and run "mvn" from this directory. This will install the commonj specifications jar in your local Maven repository from where it will be picked up when building the Tuscany SCA implementation.</li>
<li>cd back to the directory you created and check out the Tuscany SCA Java source by running the command
<p style="font-family:monospace">�svn co http://svn.apache.org/repos/asf/incubator/tuscany/java/sca/ sca</p></li>
<li>cd to the sca subdirectory and run "mvn" from this directory. This will install the Tuscany SCA Java jars in your local Maven repository. It also assembles a binary distribution in the "distribution" module under the sca directory.</li>
</ol>
<h3>Building and Running the Samples</h3>
<p>To build and run the samples in the release distribution, proceed as follows.</p>
<ol>
<li>Download the samples distribution tuscany-spec-sca-r0.95-incubator-M2-samples.tar.gz or tuscany-spec-sca-r0.95-incubator-M2-samples.zip.</li>
<li>Create a new empty directory and unpack the samples distribution into that directory.</li>
<li>Change directory to the newly created directory and run "mvn -N install". This will install the samples parent pom.xml file into your local maven repository.</li>
<li>Follow the instructions in the readme.html files for the various samples.</li>
</ol>
<p>The SCA-related samples in the latest Tuscany Java source tree in the subversion repository have been divided into two categories:</p>
<ul>
<li>Sample applications that use a mix of SCA, SDO and DAS. See "Running the Samples" on the <a href="java-projects.html#Running the Samples">Java project page</a> for details.</li>
<li>Technology samples that illustrate specific technical features of SCA and show how they can be used by an application developer. These are in the <a href="http://svn.apache.org/repos/asf/incubator/tuscany/java/samples/sca">java/samples/sca</a> module.</li>
</ul>
<h3>Tuscany SCA Java M2 files available from maven</h3>
<p>The following Tuscany SCA Java M2 files have been published to the public maven repository <a href="http://people.apache.org/repo/m2-incubating-repository/" title="http://people.apache.org/repo/m2-incubating-repository/">http://people.apache.org/repo/m2-incubating-repository/</a>
and will be downloaded automatically by maven as needed.</p>
<p>�org/apache/tuscany/sca/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/kernel/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/kernel/tuscany-api/1.0-incubator-M2/tuscany-api-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/kernel/tuscany-host-api/1.0-incubator-M2/tuscany-host-api-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/kernel/tuscany-spi/1.0-incubator-M2/tuscany-spi-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/kernel/core/1.0-incubator-M2/core-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/test/1.0-incubator-M2/test-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/services/idl/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/services/idl/wsdl/1.0-incubator-M2/wsdl-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/containers/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/services/containers/javascript/1.0-incubator-M2/javascript-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/containers/ruby/1.0-incubator-M2/ruby-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/runtime/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/runtime/webapp/1.0-incubator-M2/webapp-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/containers/spring/1.0-incubator-M2/spring-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/databinding/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/services/databinding/databinding-axiom/1.0-incubator-M2/databinding-axiom-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/databinding/databinding-sdo/1.0-incubator-M2/databinding-sdo-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/bindings/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/services/bindings/axis2/1.0-incubator-M2/axis2-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/bindings/rmi/1.0-incubator-M2/rmi-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/services/maven/1.0-incubator-M2/maven-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/runtime/webapp-host/1.0-incubator-M2/webapp-host-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/runtime/standalone/1.0-incubator-M2/standalone-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/runtime/standalone-host/1.0-incubator-M2/standalone-host-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/commands/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/commands/launcher/1.0-incubator-M2/launcher-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/sca-tools/1.0-incubator-M2/sca-tools-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/plugins/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/plugins/tuscany-war-plugin/1.0-incubator-M2/tuscany-war-plugin-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/plugins/tuscany-plugin-wsdl2java/1.0-incubator-M2/tuscany-plugin-wsdl2java-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/plugins/tuscany-plugin-java2wsdl/1.0-incubator-M2/tuscany-plugin-java2wsdl-1.0-incubator-M2.jar<br />
�org/apache/tuscany/sca/distribution/1.0-incubator-M2/distribution-1.0-incubator-M2.pom<br />
�org/apache/tuscany/sca/distribution/1.0-incubator-M2/distribution-1.0-incubator-M2-bin.zip<br />
�org/apache/tuscany/sca/distribution/1.0-incubator-M2/distribution-1.0-incubator-M2-bin.tar.gz<br />
�org/apache/tuscany/sca/samples/parent/1.0-incubator-M2/parent-1.0-incubator-M2.pom<br />
�org/osoa/sca-api-r0.95/1.0-incubator-M2/sca-api-r0.95-1.0-incubator-M2.jar<br />
�org/apache/tuscany/commonj-api_r1.1/1.0-incubator-M2/commonj-api_r1.1-1.0-incubator-M2.jar</p>
<p>The Tuscany runtime is able to download dependent jars of Tuscany extensions from the maven repositories as needed.</p>
<h3>Packaging a Standalone Tuscany Application</h3>
<p>To package a Tuscany application for running in the standalone environment (i.e., not within a web application), the application must be packaged as a jar file with the following contents:</p>
<p style="font-family:monospace">�META-INF/MANIFEST.MF<br />
�META-INF/sca/default.scdl<br />
�application executable code and resources</p>
<p>In the following instructions, we will refer to this application jar file as (executable-jar).</p>
<p>The MANIFEST.MF file must contain the following line:</p>
<p style="font-family:monospace">�Main-Class: packagename.classname</p>
<p>This is the name of the main class to be run by the Tuscany standalone launcher.</p>
<p>The default.scdl file defines the SCA components whose implementations are in the jar file. See the SCA documentation and the Tuscany samples for details of how to write an SCDL file.</p>
<h3>Running a Standalone Tuscany Application</h3>
<p>To run a Tuscany application in the standalone environment, issue the following command:</p>
<p style="font-family:monospace">�java -jar (sca-home)/bin/launcher.jar (executable-jar)</p>
<p>The standalone launcher initializes the Tuscany runtime, deploys any installed extensions (see below), creates components defined by the default.scdl file, and calls the main class of the application jar file (executable-jar).</p>
<h3>Adding Extensions to the Standalone Environment</h3>
<p>To add extensions to the standalone environment, you need to copy the required extension jars into the directory</p>
<p style="font-family:monospace">�(sca-home)/extensions</p>
<p>The launcher for the standalone environment looks for this directory and deploys all the extension jars that it finds there.</p>
<p>Applications may need a combination of extensions, and some extensions may depend on other extensions. For example, the helloworldwsclient sample needs the following extensions to be present in the extensions directory:</p>
<p style="font-family:monospace">�axis2-1.0-incubator-M2.jar<br />
�databinding-sdo-1.0-incubator-M2.jar</p>
<p>These extensions will load their required dependencies from the maven repository. The required dependencies are:</p>
<p style="font-family:monospace">�databinding-axiom-1.0-incubator-M2.jar<br />
�wsdl-1.0-incubator-M2.jar</p>
<h3>Building a Tuscany Web Application</h3>
<p>To package a Tuscany application for running in a web application container such as Apache Tomcat, the application must be packaged as a war file with some Tuscany-specific contents.</p>
<p>If you are buildng a Tuscany war file using maven, Tuscany provides a maven plugin</p>
<p style="font-family:monospace">�org/apache/tuscany/sca/plugins/tuscany-war-plugin/1.0-incubator-M2/tuscany-war-plugin-1.0-incubator-M2.jar</p>
<p>that performs this packaging. It is downloaded automatically from the maven repository when invoked by a pom.xml. For an example of how to create a pom.xml file that uses this plugin, see the pom.xml file for the webapp/calculatorws sample. Within this pom.xml file, you will see the line</p>
<p style="font-family:monospace">�<loadExtensionDependencies>false</loadExtensionDependencies></p>
<p>This instructs the Tuscany maven war plugin to create a war file that does not include dependent jar files of Tuscany extensions. Instead, these jar files will be loaded on demand by the Tuscany runtime. If the value of this element is set to true, then the Tuscany maven war plugin will bundle all required dependent jar files within the war file.</p>
<p>If you are not using maven to build a Tuscany war file, then you will need to ensure that the following files are included in the war file:</p>
<table border="0" width="95%">
<tr>
<td width="45%" valign="top">WEB-INF/default.scdl</td>
<td>see description above</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/web.xml</td>
<td>see below</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/classes</td>
<td>application executable code and resources</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/lib</td>
<td>Tuscany runtime jars from (sca-home)/lib, plus webapp-1.0-incubator-M2.jar (available from maven repository)</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/tuscany/boot</td>
<td>Tuscany runtime jars from (sca-home)/boot, plus webapp-host-1.0-incubator-M2.jar (available from maven repository)</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/tuscany/extensions</td>
<td>required Tuscany extensions</td>
</tr>
<tr>
<td width="45%" valign="top">WEB-INF/tuscany/repository/dependency.metadata</td>
<td>see below</td>
</tr>
</table>
<p>The <web-app>...</webapp> section of the WEB-INF/web.xml file must contain the following code:</p>
<p style="font-family:monospace">�<listener><br />
����<listener-class>org.apache.tuscany.runtime.webapp.TuscanyContextListener</listener-class><br />
�</listener><br />
�<servlet><br />
����<servlet-name>TuscanyServlet</servlet-name><br />
����<display-name>Tuscany Servlet</display-name><br />
����<servlet-class>org.apache.tuscany.runtime.webapp.TuscanyServlet</servlet-class><br />
�</servlet><br />
�<servlet-mapping><br />
����<servlet-name>TuscanyServlet</servlet-name><br />
����<url-pattern>/services/*</url-pattern><br />
�</servlet-mapping></p>
<p>For runtime loading of dependent jars (see the description of the <loadExtensionDependencies> element above), the WEB-INF/tuscany/repository/dependency.metadata file must contain the following code:</p>
<p style="font-family:monospace">�<?xml version="1.0" encoding="UTF-8"?><br />
�<java version="1.5.0_06" class="java.beans.XMLDecoder"><br />
��<object class="java.util.HashMap"/><br />
�</java></p>
<p>If these dependent jars are packaged within the web application's WEB-INF/tuscany/repository/ directory, please refer to the output of the Tuscany war plugin (with <loadExtensionDependencies> set to true) to see what code needs to be included within the WEB-INF/tuscany/repository/dependency.metadata file.</p>
<h3>For Further Information</h3>
<p>If you have any questions about installing, building, or running Tuscany SCA Java M2 that are not answered here, please post them to either the tuscany-user@ws.apache.org list (for end-user questions) or the tuscany-dev@ws.apache.org list (for developer questions).</p>
<br />
</td>
<td width="8" height="4" background="images/ContentBoxRS.png" >
</td>
</tr>
<tr>
<td align="right" valign="bottom"><img src= "images/ContentBoxBL.png"></td>
<td background="images/ContentBoxB.png"></td>
<td align="left"><img src="images/ContentBoxBR.png"></td>
</tr>
</tbody>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</table>
<div class="copyright">
Copyright � 2006, The Apache Software Foundation
Apache Tuscany is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Web Services PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
</div>
</body>
</html>
<!-- end the processing -->
|
