summaryrefslogtreecommitdiffstats
path: root/sca-java-1.x/tags/java-stable-20060304/samples/helloworld/helloworldaxis/readme.htm
blob: 4969bbf20e0f0fe974b3d74980d83fda674a7a03 (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
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!--
  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.
 -->
<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 Axis</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" --></head>

<body>

<h2>Tuscany Hello World Axis</h2>

<h3>Overview</h3>

<p>The Tuscany hello world axis&nbsp;sample is not an SCA application.
    &nbsp;This sample is a simple Apache Axis service. Starting from
    a&nbsp;Java source using Axis's
    java2wsdl to create a document literal WSDL. &nbsp;And then using
    that WSDL in wsdl2java to create all the Axis service and client
    artifacts. Details on this can be found reviewing the Axis
    documentation.</p>

<p>The original Java code to generate is simply:</p>

<table style="text-align: left; width: 100%; height: 262px;" border="1" cellpadding="2" cellspacing="2">

    <tbody>

        <tr>

            <td style="width: 100%;">
                <p>package org.apache.tuscany.samples.helloworldaxis;<br>

                    <br>

                    /**<br>

                    &nbsp;* <br>

                    &nbsp;*/<br>

                    <br>

                    public interface HelloWorldService{<br>

                    &nbsp;&nbsp;&nbsp; public static final String DEFAULT_NAME=
                    "World";<br>

                    &nbsp;&nbsp;&nbsp; public String getGreetings(String name);<br>

                    <br>

                    }<br>

                </p>

            </td>

        </tr>

    </tbody>
</table>

<p></p>

<p>The purpose for it's inclusion in the samples is to
    demonstrate the interoperability of &nbsp;Tuscany's web service
    binding with another SOAP implementation.</p>

<h3>Setup</h3>

The following jars are required from the Maven repository&nbsp;in
the classpath to run the sample client
<pre style="margin-left: 40px;">helloworldaxis-SNAPSHOT.jar<br>axis-1.2.1.jar<br>axis-jaxrpc-1.2.1.jar
    <br>axis-saaj-1.2.1.jar<br>axis-wsdl4j-1.5.1.jar<br>commons-discovery-0.2.jar<br>commons-logging-1.0.4.jar<br><br>
</pre>

See <a href="../helloworldws/readme.htm" target="_blank">helloworldws</a> and&nbsp; <a
        href="../helloworldaxissvc/readme.htm" target="_blank">helloworldaxissvc</a> samples for the server side service
setup instructions.<br>

<h3>Running.<br></h3>Using JDK 1.5 java command with the previous jars run the class
org.apache.tuscany.samples.helloworldaxis.HelloWorldAxisClient<br>Optional arguments: <br>&nbsp;<br>

<div style="margin-left: 40px;">&nbsp; Run against sample Tuscany SCA service: <span style="font-style: italic;">(default no arguments)</span>
    <br>&nbsp; &nbsp;&nbsp; <code>http://localhost:8080/helloworldws-SNAPSHOT/services/HelloWorldService
    World</code><br>&nbsp; Run against sample Axis Service:<br>&nbsp; &nbsp;&nbsp; <code>
    http://localhost:8080/helloworldaxissvc-SNAPSHOT/services/helloworld World</code><br></div>

<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>

More detailed information about Axis web services can be found on the
Apache Axis website.<br>

</body></html>