sca-java-1.x/branches/java-post-M1/samples/sca/helloworldws/readme.htm


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

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><!-- Copyright (c) 2005 The Apache Software Foundation or its licensors, as applicable. 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. -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><meta http-equiv="Content-Style-Type" content="text/css"><title>Tuscany
Hello World Web Service Sample</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" --><!-- maven -->
<style type="text/css" media="all">
@import url("../../../../css/maven-base.css");
@import url("../../../../css/maven-theme.css");
@import url("../../../../css/site.css");
</style><link rel="stylesheet" href="./css/print.css" type="text/css" media="print"><!-- end maven --></head>
<body><h2>Tuscany
Hello World WS Sample</h2>
<h3>Overview</h3>
<p>The Tuscany hello world ws sample shows using the Tuscany SCA
runtime in a Tomcat environment&nbsp;providing&nbsp;a web
service.</p>
<h3>Location</h3>
This sample is located &nbsp;in the samples\sca\helloworldws
directory.<br>
<h3>Setup</h3>
Set up your server as described in the <a href="../../../GettingStarted.htm" target="_blank">Tomcat
Setup</a>. &nbsp;If you are not using the pre-configured Tomcat server from the binary distribution, you will need to add
 <span style="font-weight: bold;">sample-helloworldws-incubating-M1.war</span>
to your Tomcat's webapp directory.
<h3>Running</h3>
This service can be invoked by&nbsp;the Tuscany SCA <a target="_blank" href="../helloworldwsclient/readme.htm">helloworldwsclient</a> or <a target="_blank" href="../helloworldjsclient/readme.htm">helloworldjsclient</a>
sample.<br>
<h3>Code Overview</h3>
The source files are physically organized as shown below:<br>
<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><tbody><tr><td>
<pre>+---main<br>    +---resources<br>    &brvbar;   &brvbar;   sca.module<br>    &brvbar;   &brvbar;<br>    &brvbar;   +---wsdl<br>    &brvbar;           helloworld.wsdl<br>    &brvbar;<br>    +---webapp<br>        +---WEB-INF<br>                web.xml<br></pre></td></tr></tbody></table>
<br><br><table style="text-align: left; width: 100%; height: 154px;" border="0" cellpadding="2" cellspacing="2"><tbody>
<tr><td style="vertical-align: top; height: 62px;">sca.module</td>
<td style="height: 62px;">Defines the SCA module,
entryPoint and component. Defines for the HelloWorldServiceComponent
component and the Java class that implements the component For the
entryPoint it defines WSDL for the service, the Java interface provided
by the service, and wires the service to
the&nbsp;HelloWorldServiceComponent</td>
</tr><tr>
<td>helloworld.wsdl</td>
<td>WSDL for the service.</td>
</tr><tr><td>web.xml</td>
<td>Standard J2EE web application's web.xml</td>
</tr></tbody></table>
<p>You may have noticed that there is no Java source for this
components implementation. &nbsp;There reason is this sample reuses
the code from the helloworld sample to implement the service.
</p></body></html>