You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by ja...@apache.org on 2005/06/03 12:14:18 UTC
svn commit: r179764 - /webservices/axis/trunk/java/xdocs/userguide.html
Author: jaliya
Date: Fri Jun 3 03:14:16 2005
New Revision: 179764
URL: http://svn.apache.org/viewcvs?rev=179764&view=rev
Log:
Modified the userguide for Samples - Still not complete
Modified:
webservices/axis/trunk/java/xdocs/userguide.html
Modified: webservices/axis/trunk/java/xdocs/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/userguide.html?rev=179764&r1=179763&r2=179764&view=diff
==============================================================================
--- webservices/axis/trunk/java/xdocs/userguide.html (original)
+++ webservices/axis/trunk/java/xdocs/userguide.html Fri Jun 3 03:14:16 2005
@@ -104,8 +104,10 @@
<p>To check the successful installation of a service <strong><em>available services link </em></strong> is provided. The services and the operations of successfully installed services will be displayed in the available services page. </p>
<p align="center"><img src="images/clip_image012.jpg"></p>
<p>To test run an uploaded service, instructions are provided in the samples guide about running the sample clients. However whether the service is
-present can be checked by pointing the browser to <b>http://<host>:<port>/axis2/services/<service name></b>.
-<!-- This should provide a page similar to the following -->
+present can be checked by pointing the browser to <b>http://<host>:<port>/axis2/services/<service name></b>.</p>
+<p> </p>
+<p>
+ <!-- This should provide a page similar to the following -->
</p>
<!-- Image goes here -->
@@ -128,7 +130,27 @@
Note - the directory entered as the repository loacation needs to have a services directory inside. This is
absolutely required and AXIS will not create it automatically in the case of the simple axis server.
</b></p> -->
-<h2><a name="_Toc96697863"></a>Samples </h2>
+<h2><a name="_Toc96697863"></a>Samples</h2>
+<p>In this section of the userguide we will look at how to write and deploy Web Services and how to write Web Service Clients using Axis2. All the userguide samples are located at the "modules/samples" directory. So let's explore the samples.</p>
+<h3> Web Services Using Axis2</h3>
+<p>MyService</p>
+<p>First let's see how we can write a simple Web Service (MyService) and deploy it. For this purpose we will create a Web Service with two operations with the following description.</p>
+<pre class="style1 style2 style3">public void ping(OMElement element){} //sample IN-ONLY operatoin, just accept the OMElement and do some processing.
+public OMElement echo(OMElement element){}//sample IN-OUT operation, accept an OMElement and respond with another OMElement after processing</pre>
+<p>You can find our first example Web Service(MyService) in the "modules/samples" directory under userguide/example1 package. As you can see, the two operations are very simple and need no explanations on what they are doing. So let's see how we can write the deployment desciptors for the service and depoly it.</p>
+<p>Axis2 uses "service.xml" to locate configurations for a Web Service. Each Web Service deployed under Axis2 needs a "service.xml" contining the configurations. "service.xml" for MyService will be as follows; we will see what each parameter means later.</p>
+<pre class="style1 style2 style3"><service name="MyService"><br> <description><br> This is a sample Web Service with two operations,echo and ping.<br> </description><br> <parameter name="ServiceClass" locked="xsd:false">userguide.example1.MyService</parameter><br> <operation name="echo"><br> <messageReceiver class="org.apache.axis.receivers.RawXMLINOutMessageRecevier"/><br> </operation><br> <operation name="ping"><br> <messageReceiver class="org.apache.axis.receivers.RawXMLINOutMessageRecevier"/><br> </operation><br> </service></pre>
+<p>This is used to inform Axis2 engine (once deployed) what is the service class and the operations that it contains. In addition user should specify the meand other relavent parameters (here we don't have any other). </p>
+<p>MyService with a Logging Module </p>
+<h3>Utilize Web Services Using Axis2 </h3>
+<p>Blocking</p>
+<p>Non-Blocking</p>
+<p>With Two Transports</p>
+<h3>Other Samples //Links to Google Samples </h3>
+<h2> Modules</h2>
+<h2>Tools</h2>
+<p> </p>
+<p> </p>
<p>There are three sample programs, which are listed below, that will be explained in this user guide and the relevant code can be found in the source directory under ../modules/samples/src/java/userguide/sample1. </p>
<ol>
<li>Case1: Echo Synchronous call. </li>