diff options
Diffstat (limited to 'sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldwsclient/readme.htm')
| -rw-r--r-- | sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldwsclient/readme.htm | 189 |
1 files changed, 189 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldwsclient/readme.htm b/sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldwsclient/readme.htm new file mode 100644 index 0000000000..03e1323cee --- /dev/null +++ b/sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldwsclient/readme.htm @@ -0,0 +1,189 @@ +<!--
+ 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.
+ -->
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head>
+
+ <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 Sample</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" --></head>
+
+<body>
+
+<h2>Tuscany Hello World WS Client Sample</h2>
+
+<h3>Overview</h3>
+
+<p>The Tuscany hello world WS client sample shows using the Tuscany SCA
+ runtime in a J2SE environment invoking a web service. </p>
+
+<h3>Setup</h3>
+
+The jars for a <a href="http://wiki.apache.org/ws/Tuscany/J2SESetup" target="_blank">J2SE setup</a> including those necessary
+for web services are required including the sample's own jar <span style="font-weight: bold;">helloworldwsclient-SNAPSHOT.jar</span>.
+
+<h3>Running</h3>
+Using JDK 1.5 java command with the previous mentioned jars run the
+class org.apache.tuscany.samples.helloworldwsclient.HelloWorldClient
+
+<h3>Results</h3>
+
+<p>The sample when run should simply display to the standard
+ output:<br>
+
+ <code>Hello World</code></p>
+
+<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>main<br>
+
+ +---java<br>
+
+ ¦ ¦
+ sca.module<br>
+
+ ¦ ¦<br>
+
+ ¦ +---org<br>
+
+ ¦
+ +---apache<br>
+
+ ¦
+ +---tuscany<br>
+
+ ¦
+ +---samples<br>
+
+ ¦
+ +---helloworldwsclient<br>
+ ¦
+ HelloWorldClient.java<br>
+ ¦
+ HelloWorldService.java<br>
+ ¦
+ HelloWorldServiceComponentImpl.java<br>
+
+ ¦<br>
+
+ +---resources<br>
+
+ ¦
+ tuscany-model.config<br>
+
+ ¦<br>
+
+ +---wsdl<br>
+
+
+ helloworld.wsdl<br>
+
+ <br>
+
+ </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,
+ externalService
+ and component. Defines for the
+ HelloWorldServiceComponent component and the Java class that
+ implements the component For the externalService it defines WSDL for
+ the
+ service, the Java interface provided by the service.
+ The the HelloWorldServiceComponent is via a
+ referenced wired to the externalService</td>
+
+ </tr>
+
+ <tr>
+
+ <td style="vertical-align: top;">HelloWorldClient.java</td>
+
+ <td>Creates a Tuscany runtime and starts it.
+ Obtains the module context which was defined by the
+ sca.module file. From the module context locates the
+ HelloWorldServiceComponent and then calls the getGreetings
+ method to invoke the component.</td>
+
+ </tr>
+
+ <tr>
+
+ <td style="vertical-align: top; height: 26px;">HelloWorldService.java</td>
+
+ <td style="height: 26px;">Defines the Java interface
+ implemented by the component.</td>
+
+ </tr>
+
+ <tr>
+
+ <td style="vertical-align: top;">HelloWorldServiceComponentImpl.java</td>
+
+ <td>It does not directly implement the service; instead it
+ has an SCA reference that is wired in the sca.module to an
+ externalService that will provide the service. The service providing the implementation is the <a
+ href="../helloworldws/readme.htm" target="_blank">helloworldws</a> sample.<br>
+
+ </td>
+
+ </tr>
+
+ <tr>
+
+ <td>tuscany-model.config</td>
+
+ <td>Maps the SCA Entry point WSDL to the physical WSDL file
+ location.</td>
+
+ </tr>
+
+ <tr>
+
+ <td>helloworld.wsdl</td>
+
+ <td>WSDL for the service.</td>
+
+ </tr>
+
+ </tbody>
+</table>
+
+</body></html>
|