ws-axis-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chinth...@apache.org
Subject svn commit: r154977 - in webservices/axis/trunk/java: maven.xml modules/core/project.xml modules/deployment/project.xml modules/om/project.xml modules/wsdl/project.xml xdocs/navigation.xml xdocs/releases.html xdocs/siteHowTo.html xdocs/userguide.html
Date Wed, 23 Feb 2005 06:43:58 GMT
Author: chinthaka
Date: Tue Feb 22 22:43:55 2005
New Revision: 154977

URL: http://svn.apache.org/viewcvs?view=rev&rev=154977
Log:
Changing some docs and changed the site pre goal

Modified:
    webservices/axis/trunk/java/maven.xml
    webservices/axis/trunk/java/modules/core/project.xml
    webservices/axis/trunk/java/modules/deployment/project.xml
    webservices/axis/trunk/java/modules/om/project.xml
    webservices/axis/trunk/java/modules/wsdl/project.xml
    webservices/axis/trunk/java/xdocs/navigation.xml
    webservices/axis/trunk/java/xdocs/releases.html
    webservices/axis/trunk/java/xdocs/siteHowTo.html
    webservices/axis/trunk/java/xdocs/userguide.html

Modified: webservices/axis/trunk/java/maven.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/maven.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/maven.xml (original)
+++ webservices/axis/trunk/java/maven.xml Tue Feb 22 22:43:55 2005
@@ -229,12 +229,12 @@
     <attainGoal name="dist-src"/>
     <attainGoal name="dist-bin"/>
     <attainGoal name="war"/>
+    <attainGoal name="javadoc-gen"/>
     <copy todir="target/docs/api">
-		<fileset dir="target/api" />
+		<fileset dir="target/apidocs" />
 	</copy>
 	<copy file="target/axis2.war" tofile="target/docs/dist/axis2.war"/>
 	<copy file="target/axis2-src-M1.zip" tofile="target/docs/dist/axis2-src-M1.zip"/>
 	<copy file="target/axis2-bin-M1.zip" tofile="target/docs/dist/axis2-bin-M1.zip"/>
 	<copy file="target/axis2.war" tofile="target/docs/dist/axis2.war"/>
   </preGoal>
-</project>

Modified: webservices/axis/trunk/java/modules/core/project.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/core/project.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/modules/core/project.xml (original)
+++ webservices/axis/trunk/java/modules/core/project.xml Tue Feb 22 22:43:55 2005
@@ -22,7 +22,7 @@
 
     <id>axis2-core</id>
     <name>core</name>
-    <description>Core Parts of Axis 2.0.</description>
+    <description>Core Parts of Axis 2.0. This includes Axis 2.0 engine, Client API, Addressing support, etc.,</description>
 
     <dependencies>
         <dependency>

Modified: webservices/axis/trunk/java/modules/deployment/project.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/deployment/project.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/modules/deployment/project.xml (original)
+++ webservices/axis/trunk/java/modules/deployment/project.xml Tue Feb 22 22:43:55 2005
@@ -22,7 +22,7 @@
 
     <id>axis2-deployment</id>
     <name>deployment</name>
-    <description>Deployment module of Axis 2.0.</description>
+    <description>This is the deployment mechanism in Axis 2.o which has in-built support for hot deployment</description>
 
 
     <dependencies>

Modified: webservices/axis/trunk/java/modules/om/project.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/om/project.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/modules/om/project.xml (original)
+++ webservices/axis/trunk/java/modules/om/project.xml Tue Feb 22 22:43:55 2005
@@ -22,7 +22,7 @@
 
     <id>axis2-om</id>
     <name>om</name>
-    <description>AXIOM, The Object Model of Axis 2.0.</description>
+    <description>AXIOM, The Object Model of Axis 2.0. This helps Axis 2.0 to have a light weight, efficient object model on StAX</description>
 
 
     <dependencies>

Modified: webservices/axis/trunk/java/modules/wsdl/project.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/modules/wsdl/project.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/modules/wsdl/project.xml (original)
+++ webservices/axis/trunk/java/modules/wsdl/project.xml Tue Feb 22 22:43:55 2005
@@ -22,7 +22,7 @@
 
     <id>axis2-wsdl</id>
     <name>wsdl</name>
-    <description>WSDL Parts of Axis 2.0.</description>
+    <description>WSDL Parts of Axis 2.0. This includes WSDL Object Model built based on the proposed WSDL 2.0 Component Model.</description>
 
 
     <dependencies>

Modified: webservices/axis/trunk/java/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/navigation.xml?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/xdocs/navigation.xml (original)
+++ webservices/axis/trunk/java/xdocs/navigation.xml Tue Feb 22 22:43:55 2005
@@ -23,7 +23,7 @@
       	<item name="User Guide" href="userguide.html" />
       	<item name="AXIOM Tutorial" href="OMTutorial.html" /> 
       	<item name="Client API Tutorial" href="ClientAPI.html" />
-      	     	
+      	<item name="Complete API" href="api/index.html" />      	     	
       </item>
       
       <item name="Downloads">
@@ -32,11 +32,11 @@
       	<item name="Source Code" href="cvs-usage.html" />  
       </item>
       <item name="Modules">
-      	<item name="Core" href="multiproject/axis2-Core/index.html" /> 
-      	<item name="Deployment" href="multiproject/axis2-Deployment/index.html" />
-      	<item name="OM" href="multiproject/axis2-OM/index.html" /> 
-      	<item name="WSDL" href="multiproject/axis2-WSDL/index.html" />
-      	<item name="Samples" href="multiproject/axis2-Samples/index.html" /> 
+      	<item name="Core" href="multiproject/axis2-core/index.html" /> 
+      	<item name="Deployment" href="multiproject/axis2-deployment/index.html" />
+      	<item name="OM" href="multiproject/axis2-om/index.html" /> 
+      	<item name="WSDL" href="multiproject/axis2-wsdl/index.html" />
+      	<item name="Samples" href="multiproject/axis2-samples/index.html" /> 
       </item> 
        
     </menu>

Modified: webservices/axis/trunk/java/xdocs/releases.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/releases.html?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/xdocs/releases.html (original)
+++ webservices/axis/trunk/java/xdocs/releases.html Tue Feb 22 22:43:55 2005
@@ -2,24 +2,19 @@
 <div align="center">
 	<table border="1" style="border-collapse: collapse" width="76%" id="table1">
 		<tr>
-			<td width="186" align="center">Name</td>
-			<td width="210" align="center">Date</td>
-			<td align="center">Description</td>
+			<td width="45" align="center">Name</td>
+			<td width="246" align="center">Distribution</td>
+			<td width="100" align="center">Date</td>
+			<td width="333" align="center">Description</td>
 		</tr>
 		<tr>
-			<td width="186">M1</td>
-			<td width="210">&nbsp;</td>
+			<td width="45" align="center" valign="middle"><div align="center">M1 </div></td>
+			<td width="246"> <p>Source Distribution <a href="dist/axis2-src-M1.zip">zip</a><br>
+		    Binary Distribution <a href="dist/axis2-bin-M1.zip">zip</a> <br>
+		    <a href="dist/axis2.war">War Distribution</a> <br>
+			</p></td>
+			<td width="100"><div align="center">23 - 02 - 2005  </div></td>
 			<td>Milestone Release #1</td>
-		</tr>
-		<tr>
-			<td width="186">&nbsp;</td>
-			<td width="210">&nbsp;</td>
-			<td>&nbsp;</td>
-		</tr>
-		<tr>
-			<td width="186">&nbsp;</td>
-			<td width="210">&nbsp;</td>
-			<td>&nbsp;</td>
 		</tr>
 	</table>
 </div>

Modified: webservices/axis/trunk/java/xdocs/siteHowTo.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/siteHowTo.html?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/xdocs/siteHowTo.html (original)
+++ webservices/axis/trunk/java/xdocs/siteHowTo.html Tue Feb 22 22:43:55 2005
@@ -7,9 +7,9 @@
 don't forget to put MAVEN_HOME/bin directory in the path. </p>
 <h2>Checking out Axis 2.0</h2>
 <p>Checkout latest source from
-<a href="http://svn.apache.org/repos/asf/webservices/axis/trunk/java/src">here</a> 
+<a href="http://svn.apache.org/repos/asf/webservices/axis/trunk/java">here</a> 
 using your favorite svn client. If you are a committer get a commiter check out 
-from <a href="https://svn.apache.org/repos/asf/webservices/axis/trunk/java/src">
+from <a href="https://svn.apache.org/repos/asf/webservices/axis/trunk/java">
 here</a>.</p>
 <h2>Running the build</h2>
 <div align="center">
@@ -20,20 +20,36 @@
 		</tr>
 		<tr>
 			<td width="176">maven clean</td>
-			<td>Erase all the stuff built earlier</td>
+			<td>Deletes the 'target' directory in all projects. Target directory contains the stuff created during build, site, etc., </td>
 		</tr>
 		<tr>
 			<td width="176">maven</td>
-			<td>Compile and Run the tests in Axis 2.0</td>
+			<td>Build all modules and run the tests in Axis 2.0</td>
 		</tr>
 		<tr>
-			<td width="176">maven site</td>
+			<td width="176">maven multiproject:site</td>
 			<td>Create the site for the Master project only </td>
 		</tr>
 		<tr>
 			<td width="176">maven multiproject:site </td>
 			<td>Builds the whole site </td>
 		</tr>
+		<tr>
+		  <td>maven war </td>
+		  <td>Build the war</td>
+	  </tr>
+		<tr>
+		  <td>maven war-withsamples </td>
+		  <td>build the war with the default samples and interop tests </td>
+	  </tr>
+		<tr>
+		  <td>maven dist-src </td>
+		  <td>Creates the source distribution </td>
+	  </tr>
+		<tr>
+		  <td>maven dist-bin </td>
+		  <td>Creates the binary distribution </td>
+	  </tr>
 	</table>
 </div>
 <h2>FAQ</h2>

Modified: webservices/axis/trunk/java/xdocs/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/java/xdocs/userguide.html?view=diff&r1=154976&r2=154977
==============================================================================
--- webservices/axis/trunk/java/xdocs/userguide.html (original)
+++ webservices/axis/trunk/java/xdocs/userguide.html Tue Feb 22 22:43:55 2005
@@ -22,10 +22,10 @@
 <body>
 <h1 align="center"><a name="_Toc96697849">Axis 2.0 User's Guide </a></h1>
 <p>&nbsp; </p>
-<h2><a name="_Toc96698076"></a><a name="_Toc96697851">Introduction </a></h2>
+<h3><a name="_Toc96698076"></a><a name="_Toc96697851">Introduction </a></h3>
 <p>Welcome to Axis 2.0, the next generation of Apache Axis !!! This User Guide will help you to understand what you will get from Axis 2.0 and how to get started. </p>
 <p>We hope you will benefit from the power of Axis 2.0. </p>
-<h2><a name="_Toc96698077"></a><a name="_Toc96697852">What is Axis 2.0 ? </a></h2>
+<h3><a name="_Toc96698077"></a><a name="_Toc96697852">What is Axis 2.0 ? </a></h3>
 <p>Before we start, its highly recommended to read <a href="http://ws.apache.org/axis/java/user-guide.html">Axis 1.x User's guide </a>, if you are new to Axis. </p>
 <p>Axis 2.0 is the next generation of Apache Axis. In late August 2004, during the Axis Summit held in Colombo, Sri Lanka, a new architecture was introduced to have a much more flexible, efficient and configurable Axis. Even though the architecture is new, some of the well established concepts from Axis 1.x, like handlers are preserved in Axis 2.0 also. Axis 2.0 comes with lots of new features, enhancements and new industry specification implementations. </p>
 <p>After months of continued discussion and coding effort in this direction, Axis 2.0 now delivers the following key features: </p>
@@ -42,9 +42,9 @@
   <li><strong>WSDL support.</strong> Axis 2.0 supports the <a href="http://www.w3.org/TR/wsdl">Web Service Description Language </a>, version 1.1 and 2.0, which allows you to easily build stubs to access remote services, and also to automatically export machine-readable descriptions of your deployed services from Axis. </li>
 </ul>
 <p>We hope you enjoy using Axis. Please note that this is an open-source effort - if you feel the code could use some new features or fixes, please get involved and lend a hand! The Axis developer community welcomes your participation . </p>
-<h5>Let us know what you think! </h5>
+<p>Let us know what you think! </p>
 <p>Please send feedback about the package to &quot; <a href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org </a>&quot; and make sure to prefix the subject of the mail with “[Axis2]”. </p>
-<h2><a name="_Toc96698078"></a><a name="_Toc96697853">What's in this release? </a></h2>
+<h3><a name="_Toc96698078"></a><a name="_Toc96697853">What's in this release? </a></h3>
 <p>This release includes the following features: </p>
 <ul>
   <li>SOAP 1.1/1.2 compliant engine </li>
@@ -57,7 +57,7 @@
   <li>WSDL 1.1 and 2.0 compliant Component Model </li>
   <li>Examples, including a client and server for the one-way, two-way and synchronous, asynchronous web services invocation </li>
 </ul>
-<h2><a name="_Toc96698079"></a><a name="_Toc96697854">What's still to do? </a></h2>
+<h3><a name="_Toc96698079"></a><a name="_Toc96697854">What's still to do? </a></h3>
 <p>Please see a list of what we think needs doing - and please consider helping out if you're interested &amp; able! </p>
 <ul>
   <li>Encoding/data binding </li>
@@ -67,15 +67,15 @@
   <li>Server side sync/async support </li>
   <li>Complete XML infoset support for AXIOM </li>
 </ul>
-<h1><a name="_Toc96698080"></a><a name="_Toc96697855">Installation Guide </a></h1>
-<h2><a name="_Toc96698081"></a><a name="_Toc96697856">Introduction </a></h2>
+<h2><a name="_Toc96698080"></a><a name="_Toc96697855">Installation Guide </a></h2>
+<h3><a name="_Toc96698081"></a><a name="_Toc96697856">Introduction </a></h3>
 <p>Axis 2.0 can be downloaded as a <a href="releases.html">zipped binary </a> or the <a href="cvs-usage.html">source </a>. This section describes how Axis2 can be installed either as a standalone server or as part of a J2EE compliant servlet container. </p>
-<h2><a name="_Toc96698082"></a><a name="_Toc96697857">Prerequisites </a></h2>
+<h3><a name="_Toc96698082"></a><a name="_Toc96697857">Prerequisites </a></h3>
 <p>Axis2 requires the Java Runtime Environment to be properly installed. Axis is developed to be run on JRE 1.4 and upwards but it has not been fully tested with the latest JRE 1.5. Hence it is safe to run Axis with Java 1.4. If the JRE is not already in place it must be installed to proceed further. For instructions on setting up the JRE in different operating systems, please visit <a href="http://java.sun.com/">http://java.sun.com </a>. </p>
 <p>All the required jars are shipped with the binary distribution and if the source distribution is used, running the maven build will automatically download the required jars for you. </p>
 <p>Following sections describe how each type of distribution needs to be installed. Since the process with the source distribution is similar to the binary distribution after building, the first section explains the process of building Axis from source. If you have the binary distribution you can skip the build sections and directly go to the binary installation section. </p>
-<h2><a name="_Toc96698083"></a><a name="_Toc96697858">Building Axis2 from source </a></h2>
-<h3><a name="_Toc96698084"></a><a name="_Toc96697859">Setting up the Environment and the tools </a></h3>
+<h3><a name="_Toc96698083"></a><a name="_Toc96697858">Building Axis2 from source </a></h3>
+<h4><a name="_Toc96698084"></a><a name="_Toc96697859">Setting up the Environment and the tools </a></h4>
 <p>The Axis2 build is based on <a href="http://maven.apache.org/">Maven </a>. Hence the prerequisite to build Axis2 from source is to have Maven installed. Even though extensive instruction guides are available at the Maven site, this guide also contains the “easiest path” for quick environment setting. Advanced users who wish to know more about Maven can visit <a href="http://maven.apache.org/start/index.html">here </a>. </p>
 <p>For Windows users the easiest way is to download the windows installer package. Once the installer package is run, all the necessary environment variables will be properly set. Once Maven is installed, the success of the installation can be tested by typing “maven –version” in the command prompt. </p>
 <p>&nbsp; </p>
@@ -83,14 +83,14 @@
 <p>&nbsp; </p>
 <p>For Linux users the tar ball or the zip archive is the best options. (Unfortunately there is no rpm as such that can be easily installed) Once the archive is downloaded expand it to a directory of choice and set the environment variable “MAVEN_HOME” and add MAVEN_HOME/bin to the path as well. More instructions for installing Maven in UNIX based operating systems can be found <a href="http://maven.apache.org/start/install.html">here </a>. </p>
 <p>Once maven is properly installed it's all that is needed to start building Axis2. </p>
-<h3><a name="_Toc96698085"></a><a name="_Toc96697860">The Axis source distribution </a></h3>
-<p>The <a href="cvs-usage.html">source distribution </a> is available as a zipped archive or a tar ball. All the necessary build scripts are included with the source distribution. Once the source archive is expanded into a directory of choice, moving to the particular directory and typing maven will build the axis jar file. </p>
+<h4><a name="_Toc96698085"></a><a name="_Toc96697860">The Axis source distribution </a></h4>
+<p>The <a href="releases.html">source distribution </a> is available as a zipped archive or a tar ball. All the necessary build scripts are included with the source distribution. Once the source archive is expanded into a directory of choice, moving to the particular directory and typing maven will build the axis jar file. </p>
 <p align="center"><img width="540" height="292" src="images/clip_image004.jpg"></p>
 <p>Once the command completes, the binaries (jar files in this case) can be found at a newly created “target” directory. </p>
 <p><strong>Note – For the first Maven build (if the maven repository is not built first) it will take a while since required jars need to be downloaded. However this is a once only process and will not affect any successive builds. </strong></p>
 <p><strong> </strong>The default maven build will however build only the Axis2 jar file. To obtain a WAR (Web Archive), “maven war” command should be issued. This will create a complete WAR with the name axis2.war inside the target directory. </p>
 <p>Once this build step is complete, the binaries are ready to be deployed. </p>
-<h2><a name="_Toc96698086"></a><a name="_Toc96697861">Installing Axis2 in a Servlet container </a></h2>
+<h3><a name="_Toc96698086"></a><a name="_Toc96697861">Installing Axis2 in a Servlet container </a></h3>
 <p>Installation of the WAR is quite simple. It's a matter of dropping the war in the webapps folders and most servlet containers will automatically install the war. However some servlet containers may require a restart in order to capture the new web application. Please refer your servlet container documentation for more information about this. </p>
 <p>Once the WAR is successfully installed it can be tested by pointing the web browser to the <strong>http:// &lt;host :port&gt;/ axis2. </strong>It should produce the following page. </p>
 <p align="center"><strong><img width="624" height="439" src="images/clip_image006.jpg"></strong></p>
@@ -108,7 +108,7 @@
 </p>
 <!-- Image goes here -->
 
-<h2><a name="_Toc96698087"></a><a name="_Toc96697862">Running the Axis2 standalone server </a></h2>
+<h3><a name="_Toc96698087"></a><a name="_Toc96697862">Running the Axis2 standalone server </a></h3>
 <p>Since a J2EE servlet container can be heavy in certain cases, a simple socket server is provided with Axis2. </p>
 Start scripts are inluded in the bin directory of the binary distribution.</p>
 <p>For windows</p>
@@ -127,7 +127,7 @@
  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>
-<h1><a name="_Toc96697863"></a><a name="_Toc96698088">Samples </a></h1>
+<h2><a name="_Toc96697863"></a><a name="_Toc96698088">Samples </a></h2>
 <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>
@@ -138,16 +138,15 @@
 <p align="center"><img src="images/cases.jpg" width="467" height="246"></p>
 
 <p> Axis2 M1 currently does not support the data binding, thus in the samples the operation that will be supported will be the echoing of xml without data binding. The message that will be sent and echoed will be the following.</p>
-<p class="style1 style2 style3">&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
-xmlns:sample1="http://sample1.org/sample1"&gt;<br/>
-&nbsp;&nbsp;&nbsp;&nbsp; &lt;soapenv:Header/&gt;<br/>
-&nbsp;&nbsp;&nbsp;&nbsp; &lt;soapenv:Body&gt;<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;sample1:echo&gt;<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;sample1:Text&gt;Axis2
-  Echo String&lt;/sample1:Text&gt; &nbsp;<br/>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sample1:echo&gt;<br/>
-&nbsp;&nbsp;&nbsp; &lt;/soapenv:Body&gt;<br/>
-&lt;/soapenv:Envelope&gt;<br/>
+<pre class="style1 style2 style3">&lt;soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sample1="http://sample1.org/sample1"&gt;
+ &nbsp;&nbsp;&nbsp;&nbsp; &lt;soapenv:Header/&gt;
+ &nbsp;&nbsp;&nbsp;&nbsp; &lt;soapenv:Body&gt;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;sample1:echo&gt;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;sample1:Text&gt;Axis2   Echo String&lt;/sample1:Text&gt; &nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;/sample1:echo&gt;
+ &nbsp;&nbsp;&nbsp; &lt;/soapenv:Body&gt;
+ &lt;/soapenv:Envelope&gt;
+ </pre>
 <p>The Sample1 can be located at the src/samples/userguide/sample1 directory and it will have (or eventually have after the build) the following files. </p>
 <p>&nbsp;</p>
 <table width="756" align="center" border="1"  cellpadding="0" cellspacing="0">
@@ -233,7 +232,7 @@
     <td valign="top"><p>The jar that bundles the server side and client side code. </p></td>
   </tr>
 </table>
-<h2><a name="_Toc96698089"></a><a name="_Toc96697864">Pre-Conditions </a></h2>
+<h3><a name="_Toc96698089"></a><a name="_Toc96697864">Pre-Conditions </a></h3>
 <p>Axis2 should be installed (see the Installation guide above). For simplicity samples will assume the servlet container is Tomcat. </p>
 <p>AXIS_HOME environment variable be set. (Rationale: The compile time and runtime libraries required in the classpath for the samples will be picked up form the deployed Asix2.) </p>
 <p align="center"><img width="384" height="430" src="images/clip_image014.jpg"></p>
@@ -252,7 +251,7 @@
 	<li>sample1-all.jar – Compiled sources required for running the client applications (Packaged to modules/samples/build/lib)</li>
 </ul>
 <p>Once the sample is compiled once, all the required jar files for deploying and running all three Cases of the sample will be compiled and packaged.</p>
-<h2><a name="_Toc96698091"></a><a name="_Toc96697866">Sample1- Case1 : Echo Synchronous call </a></h2>
+<h3><a name="_Toc96698091"></a><a name="_Toc96697866">Sample1- Case1 : Echo Synchronous call </a></h3>
 <p>The sample1 - Case1: Echo synchronous call is intended to demonstrate the synchronous web service call in Axis2 with both the client side and client side running Axis2. In the next few steps the user will be walked through in: </p>
 <ul>
   <li>Compiling and building a web service </li>
@@ -262,18 +261,19 @@
 
 <p>It is assumed that the sample is already compiled. Please refer "Building Sample1" above.</p>
 
-<h3><strong>Building the sample </strong></h3>
+<h4><strong>Building the sample </strong></h4>
 <p>Building the sample will take only one step provided that pre-conditions are met. In the build file there is a target called compile that will compile the sample and create the sample1.jar in the build/services directory. So the user should open a command prompt and cd to the &quot;modules/samples&quot; directory and type </p>
 <p>&gt;ant compile </p>
 <p>and it will show the following output. </p>
 <p align="center"><img width="648" height="362" src="images/clip_image016.jpg"></p>
 <p>Now the user can actually go check for the sample1-all.jar in the lib directory and the packaged web service in the <strong>sample1.jar </strong>in the modules\samples\build\services directory. </p>
 
-<h3><strong>Deploying the sample </strong></h3>
+<h4><strong>Deploying the sample </strong></h4>
 <p>Before deploying the sample, it is necessary to package the web service. The actual web service implementation is the EchoXML.java and it is necessary to write a service.xml so that the necessary statistics about the service will be available to the Axis 2 engine at the runtime. </p>
-<p class="style1 style2 style3">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt; <br> 
- &nbsp;&nbsp;&lt;java:implementation class=&quot;userguide.sample1.EchoXML&quot; xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt;<br>&nbsp;&nbsp;&lt;operation name=&quot;echo&quot; qname=&quot;echo&quot;/&gt;  
-<br>&lt;/service&gt;
+<pre class="style1 style2 style3">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt; 
+   &nbsp;&nbsp;&lt;java:implementation class=&quot;userguide.sample1.EchoXML&quot; xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt;
+&nbsp;&nbsp;&lt;operation name=&quot;echo&quot; qname=&quot;echo&quot;/&gt;   
+&lt;/service&gt; </pre>
 <p>Above service.xml provides five required types of information. </p>
 <ul>
   <li>Provider – Provider that will invoke the service. </li>
@@ -297,56 +297,41 @@
 </ol>
 <p>If the servlet container is now running the user can go check to see weather the above services are deployed. Please refer the installation guide for further information on checking the deployed services. </p>
 <p align="center"><img width="647" height="434" src="images/clip_image020.jpg"></p>
-<h3><strong>Running the sample </strong></h3>
+<h4><strong>Running the sample </strong></h4>
 <p>The sample provides a simple synchronous client in the SynchronousClient.java class. First the user must start the servlet container and run the client by simply typing </p>
 <p>&gt;ant echo </p>
 <p>in the command prompt. If all goes well the user will get the following output where the program will print the request SOAP message and the response SOAP message, which will be same as the request message. </p>
 <p align="center"><img width="648" height="269" src="images/clip_image022.jpg"></p>
-<h2><a name="_Toc96698092"></a><a name="_Toc96697867">Sample1 - Case2: Echo Synchronous call with a phased handler. </a></h2>
+<h3><a name="_Toc96698092"></a><a name="_Toc96697867">Sample1 - Case2: Echo Synchronous call with a phased handler. </a></h3>
 <p>This example will go one step forward from the example above and will deploy a web service with a Logging handler. The client application will not change, of course with an exception; the Endpoint Reference will be changed to refer the new service <strong>“Sample1WithHandler” </strong>. </p>
 <p>There is a Handler (LoggingHandler.java) that is introduced in this case and it will basically log the fact that it got called. The code can be found in LoggingHandler.java. </p>
-<p class="style1 style2 style3">public void invoke(MessageContext msgContext) throws AxisFault {
-<br>&nbsp;&nbsp;log.info(&quot;Incoming message From &quot;+msgContext.getTo().getAddress()); 
+<pre class="style1 style2 style3">public void invoke(MessageContext msgContext) throws AxisFault { 
+&nbsp;&nbsp;log.info(&quot;Incoming message From &quot;+msgContext.getTo().getAddress());   
 
-<br><br>public void revoke(MessageContext msgContext){ 
-<br>&nbsp;&nbsp;log.info(&quot;Incoming message Revoked at the server &quot;+msgContext.getTo().getAddress() ); 
-<br>} </p>
+public void revoke(MessageContext msgContext){  
+&nbsp;&nbsp;log.info(&quot;Incoming message Revoked at the server &quot;+msgContext.getTo().getAddress() );  
+} </pre>
 <p>It is assumed that the sample is compiled. Please refer "Building Sample" above.</p>
-<h3><strong>Deploying the sample </strong></h3>
+<h4><strong>Deploying the sample </strong></h4>
 <p>The implementation of the web service will be EchoXML, operation will be echo and the provider will be org.apache.axis.providers.RawXMLProvider, which are similar to that of the <strong>“Echo Synchronous call” </strong>. The difference is that there will be a handler that will be added in the server side. For further discussion refer the following service.xml which will be used in deploying the service. </p>
-<p class="style1 style2 style3">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt; <br>
-&nbsp;&lt;java:implementation class=&quot;userguide.sample1.EchoXML&quot; xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt;
-&nbsp;&nbsp;
-<p class="style1 style2 style3">&nbsp;&nbsp;&lt;inflow&gt; 
-  <br>
-&nbsp;&nbsp;&nbsp;&nbsp;&lt;handler name=&quot;LoggingHandler&quot; class=&quot;userguide.sample1.LoggingHandler&quot;&gt; 
-<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;order phase=&quot;Logging&quot;/&gt; 
-<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&lt;/handler&gt; 
-<br>
-&nbsp;&nbsp;&lt;/inflow&gt; 
-<br>
-<br>
-&nbsp;&nbsp;&lt;outflow&gt; 
-<br>
-&nbsp;&nbsp;&lt;/outflow&gt; 
-<br>
-<br>
-&nbsp;&nbsp;&lt;faultflow&gt; 
-<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&lt;handler name=&quot;LoggingHandler&quot; class=&quot;userguide.sample1.LoggingHandler&quot;&gt; 
-<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;order phase=&quot;Logging&quot;/&gt;
-<br>
-&nbsp;&nbsp;&nbsp;&nbsp;&lt;/handler&gt; 
-<br>
-&nbsp;&nbsp;&lt;/faultflow&gt; 
-<br>
-<br>
-&nbsp;&nbsp;&lt;operation name=&quot;echo&quot; qname=&quot;echo&quot;/&gt; 
-<br>
-&lt;/service&gt; </p>
+<pre class="style1 style2 style3">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt; 
+ &nbsp;&lt;java:implementation class=&quot;userguide.sample1.EchoXML&quot; xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt; &nbsp;&nbsp; </pre><pre class="style1 style2 style3">&nbsp;&nbsp;&lt;inflow&gt;    
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;handler name=&quot;LoggingHandler&quot; class=&quot;userguide.sample1.LoggingHandler&quot;&gt;  
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;order phase=&quot;Logging&quot;/&gt;  
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;/handler&gt;  
+ &nbsp;&nbsp;&lt;/inflow&gt;  
+ 
+ &nbsp;&nbsp;&lt;outflow&gt;  
+ &nbsp;&nbsp;&lt;/outflow&gt;  
+ 
+ &nbsp;&nbsp;&lt;faultflow&gt;  
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;handler name=&quot;LoggingHandler&quot; class=&quot;userguide.sample1.LoggingHandler&quot;&gt;  
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;order phase=&quot;Logging&quot;/&gt; 
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;/handler&gt;  
+ &nbsp;&nbsp;&lt;/faultflow&gt;  
+ 
+ &nbsp;&nbsp;&lt;operation name=&quot;echo&quot; qname=&quot;echo&quot;/&gt;  
+ &lt;/service&gt; </pre>
 <p>In extra this service.xml has defined three elements </p>
 <ol>
   <li>inflow </li>
@@ -355,70 +340,55 @@
 </ol>
 <p>These refer to the flows of the Axis2 server and further information of each could be found in the Architecture Guide. Using these elements the deployer can specify what handlers should go into which each flow. It can be further explained by referring to the entries in the above service.xml. In the above descriptor for the inflow and the faultfow there is a handler element that is added. At the deployment time, Axis2 will incorporate that handler to both the inflow and the fault flow. Since there is no such entry for the outflow no handler will be associated with the outflow. </p>
 <p>Handler should specify the implementation class and the phase that it belongs to. In this case the handler belong to the <strong>Logging </strong> phase and this phase name should be one of that is defined in the <strong>server.xml </strong>(not service.xml). So this <strong>Logging </strong> phase should be defined there in the server.xml which is located in AXIS_HOME/ axis2/WEB-INF. The following is the default server.xml that is shipped with axis2.war. </p>
-<p class="style1 style9  style2 style3">&lt;server name=&quot;AxisJava2.0&quot;&gt;
-  <br>
-  &nbsp;&nbsp;&lt;parameter name=&quot;hotdeployment&quot; locked=&quot;xsd:false&quot;&gt;true&lt;/parameter&gt; 
-  <br>
-  &nbsp;&nbsp;&lt;parameter name=&quot;hotupdate&quot; locked=&quot;xsd:false&quot;&gt;true&lt;/parameter&gt; 
-  <br>
-  &nbsp;&nbsp;&lt;transports&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;transport name=&quot;http&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;transport name=&quot;smtp&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&lt;/transports&gt; 
-  <br>
-  &nbsp;&nbsp;&lt;phaseOrder&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;global&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;transport&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;Logging&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;module&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;service&quot;/&gt; 
-  <br>
-  &nbsp;&nbsp;&lt;/phaseOrder&gt; 
-  <br>
-&lt;/server&gt;  </p>
+<pre class="style1 style9  style2 style3">&lt;server name=&quot;AxisJava2.0&quot;&gt;   
+   &nbsp;&nbsp;&lt;parameter name=&quot;hotdeployment&quot; locked=&quot;xsd:false&quot;&gt;true&lt;/parameter&gt;    
+   &nbsp;&nbsp;&lt;parameter name=&quot;hotupdate&quot; locked=&quot;xsd:false&quot;&gt;true&lt;/parameter&gt;    
+   &nbsp;&nbsp;&lt;transports&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;transport name=&quot;http&quot;/&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;transport name=&quot;smtp&quot;/&gt;    
+   &nbsp;&nbsp;&lt;/transports&gt;    
+   &nbsp;&nbsp;&lt;phaseOrder&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;global&quot;/&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;transport&quot;/&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;Logging&quot;/&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;module&quot;/&gt;    
+   &nbsp;&nbsp;&nbsp;&nbsp;&lt;phase name=&quot;service&quot;/&gt;    
+   &nbsp;&nbsp;&lt;/phaseOrder&gt;    
+ &lt;/server&gt;  </pre>
 <p>Since the Logging phase is there in the default server.xml the user who runs these samples need not edit the server.xml at all. </p>
 <p>Nevertheless deploying the sample is very easy and it can be done in any of the three methods described in the <strong>“Echo Synchronous call” </strong> case. Infact had the use typed </p>
 <p>&gt;ant deploy </p>
 <p>and deployed the service in the <strong>“Echo Synchronous call” </strong> case then this service too will be deployed. The relevant jar file is <strong>sample1WithHandler.jar </strong> and will be packed to \build\services directory if the user wants to deploy it manually or upload using the web application. </p>
-<h3><strong>Running the sample </strong></h3>
+<h4><strong>Running the sample </strong></h4>
 <p>In this case the client side is similar to that of <strong>“Echo Synchronous call” </strong>. The changes are happening in the server side in this case. The same SynchronousClient.java can be used to invoke the service by changing the command line arguments. Refer the ant target for details </p>
-<p class="style4">&lt;target name= &quot;echo&quot; depends= &quot;compile&quot; &gt; 
-<br>
-&nbsp;&nbsp;&lt;java classname= &quot;userguide.sample1.SynchronousClient&quot;&gt;
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;classpath refid= &quot;classpath.runtimelibraries&quot; /&gt; 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;8080&quot; /&gt; 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;/axis2/services/sample1&quot; /&gt; 
-<br>&nbsp;&nbsp;&lt;/java&gt; 
-<br>&lt;/target&gt; 
-<br><br>&lt;target name= &quot;echoWithHandler&quot; &gt; 
-<br>
-&nbsp;&nbsp;&lt;java classname= &quot;userguide.sample1.SynchronousClient&quot; &gt; 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;classpath refid= &quot;classpath.runtimelibraries&quot; /&gt; 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;8080&quot; /&gt; 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;/axis2/services/sample1WithHandler&quot; /&gt; 
-<br>&nbsp;&nbsp;&lt;/java&gt; 
-<br>&lt;/target&gt; </p>
+<pre class="style4">&lt;target name= &quot;echo&quot; depends= &quot;compile&quot; &gt;  
+ &nbsp;&nbsp;&lt;java classname= &quot;userguide.sample1.SynchronousClient&quot;&gt; 
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;classpath refid= &quot;classpath.runtimelibraries&quot; /&gt;  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;8080&quot; /&gt;  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;/axis2/services/sample1&quot; /&gt;  
+&nbsp;&nbsp;&lt;/java&gt;  
+&lt;/target&gt;  
+
+&lt;target name= &quot;echoWithHandler&quot; &gt;  
+ &nbsp;&nbsp;&lt;java classname= &quot;userguide.sample1.SynchronousClient&quot; &gt;  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;classpath refid= &quot;classpath.runtimelibraries&quot; /&gt;  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;8080&quot; /&gt;  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;arg value= &quot;/axis2/services/sample1WithHandler&quot; /&gt;  
+&nbsp;&nbsp;&lt;/java&gt;  
+&lt;/target&gt; </pre>
 <p>To run the sample first the user must start the servlet container and run the client by simply typing </p>
 <p>&gt;ant echoWithHandler </p>
 <p>in the command prompt. If all goes well the user will get the following output where the program will print the request SOAP message and the response SOAP message, which will be same as the request message. </p>
 <p align="center"><img width="648" height="265" src="images/clip_image024.jpg"></p>
 <p>The service <strong>“sample1withhandler” </strong> will run its logging handler as it gets called and it will log the call as the handler gets called in the inflow. This logged information can be found in the server logs. </p>
-<h2><a name="_Toc96698093"></a><a name="_Toc96697868">Sample1 - Case3: Echo Asynchronous call. </a></h2>
+<h3><a name="_Toc96698093"></a><a name="_Toc96697868">Sample1 - Case3: Echo Asynchronous call. </a></h3>
 <p>In this case the example focuses on calling a synchronous web service in an asynchronous manner in the client side. If this example is compared with the first example, which is <strong>“Echo Synchronous call” </strong>, the server side is identical for both the cases. The difference will be in the web service client that will be used. </p>
 <p>In this case the client will make a web service call and it will register a call back handler and sends the message out. The difference will be that the client application that is doing the web service call will not hang till the response. Rather it will get returned and once the response returns the client will get notified by way of the registered callback (This is one of the two methods this can be done in Axis 2.0. Refer <a href="ClientAPI.html">Client Api Tutorial </a> for more information). </p>
 <p>The callback handler that will be used is ClientEchoCallbackHandler.java and the client program is AsynchronousClient.java. </p>
 
 <p>It is assumed that the sample is already compiled. Please refer the "Building Sample1" above. </p>
 <p>On the other hand the Case3 uses the <strong>sample1</strong> web service. Thus if the user has already deployed sample1 web service in Case1 above then there is no requirement of deploying again. Please refer Case1 deploying to deploy the required service above.</p>
-<h3><strong>Running the sample </strong></h3>
+<h4><strong>Running the sample </strong></h4>
 <p>The class to run is AsynchronousClient.java and it will intialise the web service call. It will register a call back in this case an instance of the ClientEchoCallbackHandler and then client will sleep to keep the thread alive. Eventually when the response is received the callback handler will be called(if all goes well onComplete() method will be called), in this case the ClientEchoCallbackHandler instance that was registered. </p>
 <p>Inside the ClientEchoCallbackHandler it will print the received SOAP message. Please refer the code. </p>
 <p>To run the client one can simply type </p>
@@ -428,28 +398,24 @@
 <p>&nbsp; </p>
 <strong><br>
 </strong>
-<h1><a name="_Toc96698094"></a><a name="_Toc96697869">Writing your own Service and a client </a></h1>
-<h2><a name="_Toc96698095"></a><a name="_Toc96697870">Writing a New Service </a></h2>
+<h2><a name="_Toc96698094"></a><a name="_Toc96697869">Writing your own Service and a client </a></h2>
+<h3><a name="_Toc96698095"></a><a name="_Toc96697870">Writing a New Service </a></h3>
 <p>Writing a new Web Service in Axis2-M1 requires you to do following steps </p>
 <p><strong>&#149;&nbsp; Writing a new Web Service implementation class </strong></p>
 <p>Axis2 M1 does not support data binding and supports only the XML level messaging. The default provider (do not worry about this if you do not know what it is) only supports the java methods having the return type as OMElement and only parameter as an OMElement. </p>
 <p>The OMElement is a Streaming representation of XML Message Element Information Item (Even though the user sees the OMElement as a tree based DOM/JDOM like node, it reads the information from the stream only when its absolutely required.). For more information refer the <a href="OMTutorial.html">OM Tutorial </a>. </p>
-<p class="style4">public class &lt;class-name&gt;{ 
-<br>&nbsp;&nbsp;public OMElelemnt &lt;method-name&gt;(OMEllemnt){ 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;&lt;business logic&gt; 
-<br>&nbsp;&nbsp;} 
-<br>&nbsp;&nbsp;..... 
-<br>} </p>
+<pre class="style4">public class &lt;class-name&gt;{  
+&nbsp;&nbsp;public OMElelemnt &lt;method-name&gt;(OMEllemnt){  
+&nbsp;&nbsp;&nbsp;&nbsp;&lt;business logic&gt;  
+&nbsp;&nbsp;}  
+&nbsp;&nbsp;.....  
+} </pre>
 <p><strong>&#149;&nbsp; Write the service.xml file </strong></p>
 <p>the following XML snippet is a very simple service.xml file. </p>
-<p class="style4">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt; 
-<br>
-&nbsp;&nbsp;&lt;java:implementation class=&quot;&lt;implementation-classname&gt;&quot; 
-xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt; 
-<br>
- &nbsp;&nbsp;&lt;operation name=&quot;&lt;method-name&gt;&quot; qname=&quot;&lt;method-name&gt;&quot;/&gt; ... 
-<br>
-&lt;/service&gt; </p>
+<pre class="style4">&lt;service provider=&quot;org.apache.axis.providers.RawXMLProvider&quot; style=&quot;rpc&quot;&gt;  
+ &nbsp;&nbsp;&lt;java:implementation class=&quot;&lt;implementation-classname&gt;&quot;  xmlns:java=&quot;http://ws.apache.org/axis2/deployment/java&quot;/&gt;  
+  &nbsp;&nbsp;&lt;operation name=&quot;&lt;method-name&gt;&quot; qname=&quot;&lt;method-name&gt;&quot;/&gt; ...  
+ &lt;/service&gt; </pre>
 <p>Here the org.apache.axis.providers.RawXMLProvider is the default provider for the Apache Axis2 M1, the provider can be changed by specifying the relevant parameter. Note that &lt;method-name&gt; should be replaced by the relevant method name. </p>
 <p><strong>&#149;&nbsp; Create an archive with the service.xml file and with class files </strong></p>
 <p>Compile the the Web Service implementation class and any other supporting class. Archive them in to a jar file. Place the service.xml file in the META-INF directory. </p>
@@ -461,16 +427,16 @@
 service.xml as well. The tool start script can be found in the bin directory. 
 
 
-<h2><a name="_Toc96698096"></a><a name="_Toc96697871">Writing a Client for the Axis2-M1 </a></h2>
+<h3><a name="_Toc96698096"></a><a name="_Toc96697871">Writing a Client for the Axis2-M1 </a></h3>
 <p>Axis2 M1 supports HTTP transport only. Axis2-M1 supports the following interaction patterns. </p>
 <p>&#149;&nbsp; Blocking invocation of type in-out (request/response) </p>
 <p>&#149;&nbsp; Non blocking invocation of type in-out (Without a separate Listener) </p>
 <p>for more information about the interaction patterns, visit the <a href="ClientAPI.html">Client API Tutorial </a>. </p>
 <p>To invoke the web service, user needs to build the the SOAPEnvelope himself. The SOAPEnvelope can be built by the following code. </p>
-<p class="style4">OMFactory fac = OMFactory.newInstance(); 
-<br>SOAPEnvelope envelope = fac.getDefaultEnvelope(); 
-<br>OMElement omElement = ..... 
-<br>envelope.getBody().addChild(omElement); </p>
+<pre class="style4">OMFactory fac = OMFactory.newInstance();  
+SOAPEnvelope envelope = fac.getDefaultEnvelope();  
+OMElement omElement = .....  
+envelope.getBody().addChild(omElement); </pre>
 <p>OMElement can be build using one of the following methods; </p>
 <ol>
   <li>Create a OM by building the OM tree <br>
@@ -480,42 +446,42 @@
 <ol>
   <li>Create a OM Element from a XML file 
  <br>
- <span class="style4">XMLStreamReader parser = XMLInputFactory.newInstance().createXMLStreamReader(new FileReader(file)); <br>
+ <pre class="style4">XMLStreamReader parser = XMLInputFactory.newInstance().createXMLStreamReader(new FileReader(file)); <br>
   OMXMLParserWrapper builder = OMXMLBuilderFactory.createStAXOMBuilder(OMFactory.newInstance(), parser); <br>
 builder.getDocumentElement();
  </span></li>
 </ol>
 <p>for more information in handling the OM objects please read the <a href="OMTutorial.html">OM Tutorial </a>. </p>
-<h3><a name="_Toc96698097"></a><a name="_Toc96697872">Synchronous Client </a></h3>
+<h4><a name="_Toc96698097"></a><a name="_Toc96697872">Synchronous Client </a></h4>
 <p>Invoking the synchronous web service call can be done with the following code. </p>
-<p class="style4">EndpointReference targetEPR = <strong>new </strong>EndpointReference(AddressingConstants.WSA_TO, &quot;http://127.0.0.1:&quot; + (EngineUtils.TESTING_PORT) + &quot;/axis/services/echo&quot; ); 
-<br>Call call = <strong>new </strong>Call(); 
-<br>call.setTo(targetEPR); 
-<br>SOAPEnvelope responseEnv = call.sendReceive(envelope); </p> 
+<pre class="style4">EndpointReference targetEPR = <strong>new </strong>EndpointReference(AddressingConstants.WSA_TO, &quot;http://127.0.0.1:&quot; + (EngineUtils.TESTING_PORT) + &quot;/axis/services/echo&quot; );  
+Call call = <strong>new </strong>Call();  
+call.setTo(targetEPR);  
+SOAPEnvelope responseEnv = call.sendReceive(envelope); </pre> 
 <p>&#149;&nbsp; The Endpoint Reference (EPR) is the To location of the web service. </p>
 <p>&#149;&nbsp; call.setTo() method registers the created EPR with the call object. </p>
 <p>&#149;&nbsp; call.sendRecieve() method invokes the web service at the location specified by the EPR using the given SOAP Message. </p>
-<h3><a name="_Toc96698098"></a><a name="_Toc96697873">Asynchronous Client </a></h3>
+<h4><a name="_Toc96698098"></a><a name="_Toc96697873">Asynchronous Client </a></h4>
 <p>Invoking the asynchronous web service call can be done with the following code. </p>
-<p class="style4">EndpointReference targetEPR = <strong>new </strong>EndpointReference(AddressingConstants.WSA_TO, &quot;http://127.0.0.1:&quot; + (EngineUtils.TESTING_PORT)+ &quot;/axis/services/echo&quot; ); 
-<br>Call call = <strong>new </strong>Call(); 
-<br>call.setTo(targetEPR); 
-<br>call.setListenerTransport(Constants.TRANSPORT_HTTP, <strong>true </strong>); 
-<br>SOAPEnvelope responseEnv = call.sendReceiveAsync(envelope,callback); </p>
+<pre class="style4">EndpointReference targetEPR = <strong>new </strong>EndpointReference(AddressingConstants.WSA_TO, &quot;http://127.0.0.1:&quot; + (EngineUtils.TESTING_PORT)+ &quot;/axis/services/echo&quot; );  
+Call call = <strong>new </strong>Call();  
+call.setTo(targetEPR);  
+call.setListenerTransport(Constants.TRANSPORT_HTTP, <strong>true </strong>);  
+SOAPEnvelope responseEnv = call.sendReceiveAsync(envelope,callback); </pre>
 <p>&#149;&nbsp; The Endpoint Reference (EPR) is the To location of the web service. </p>
 <p>&#149;&nbsp; call.setTo() method registers the created EPR with the call object. </p>
 <p>&#149;&nbsp; call.sendRecieveAsync() method invokes the web service at the location specified by the EPR using the given SOAP Message. </p>
 <p>&#149;&nbsp; The LitenerTransport is type of the trasport to be used. Axis2-M1 only supports the http and the second parameter express the should the seperate listener is to be started or not. Axis-M1 supports only the true for this. </p>
 <p>&#149;&nbsp; callback it the Callback to handle the response e.g. </p>
-<p class="style1 style2 style3">Callback callback = <strong>new </strong> Callback() { 
-<br><strong>&nbsp;&nbsp;public void </strong>onComplete(AsyncResult result) { 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;//process the result 
-<br>&nbsp;&nbsp;} 
-<br>&nbsp; 
-<br><strong>&nbsp;&nbsp;public void </strong>reportError(Exception e) { 
-<br>&nbsp;&nbsp;&nbsp;&nbsp;//handler error 
-<br>&nbsp;&nbsp;} 
-<br>}</p>
+<pre class="style1 style2 style3">Callback callback = <strong>new </strong> Callback() {  
+<strong>&nbsp;&nbsp;public void </strong>onComplete(AsyncResult result) {  
+&nbsp;&nbsp;&nbsp;&nbsp;//process the result  
+&nbsp;&nbsp;}  
+&nbsp;  
+<strong>&nbsp;&nbsp;public void </strong>reportError(Exception e) {  
+&nbsp;&nbsp;&nbsp;&nbsp;//handler error  
+&nbsp;&nbsp;}  
+}</pre>
 <p>&nbsp; </p>
 <p>&nbsp; </p>
 </body>



Mime
View raw message