axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cha...@apache.org
Subject svn commit: r395490 [1/3] - in /webservices/axis2/trunk/java/xdocs: ./ latest/
Date Thu, 20 Apr 2006 05:32:07 GMT
Author: chatra
Date: Wed Apr 19 22:32:05 2006
New Revision: 395490

URL: http://svn.apache.org/viewcvs?rev=395490&view=rev
Log:
making updates & improvements

Modified:
    webservices/axis2/trunk/java/xdocs/index.html
    webservices/axis2/trunk/java/xdocs/latest/index.html
    webservices/axis2/trunk/java/xdocs/latest/installationguide.html
    webservices/axis2/trunk/java/xdocs/latest/userguide.html
    webservices/axis2/trunk/java/xdocs/latest/userguide1.html
    webservices/axis2/trunk/java/xdocs/latest/userguide2.html
    webservices/axis2/trunk/java/xdocs/latest/userguide3.html
    webservices/axis2/trunk/java/xdocs/latest/userguide4.html
    webservices/axis2/trunk/java/xdocs/latest/userguide5.html

Modified: webservices/axis2/trunk/java/xdocs/index.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/index.html?rev=395490&r1=395489&r2=395490&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/index.html (original)
+++ webservices/axis2/trunk/java/xdocs/index.html Wed Apr 19 22:32:05 2006
@@ -13,6 +13,7 @@
 
 
 
+
   </style>
 </head>
 
@@ -58,7 +59,7 @@
 
 <p>This release includes the following features:</p>
 
-<h4 id="head-215f3945a40558f9ad055ed5b6601e8f93706558">Axis2 Complete
+<h4 id="head-215f3945a40558f9ad055ed5b6601e8f93706558">Axis2 Completed
 Features List</h4>
 <ol type="1">
   <li>AXIOM, an XML object model working on StAX (Streaming API for XML)
@@ -92,16 +93,16 @@
   <li>Module disengagement support</li>
   <li>Loading module (.mar) from classpath</li>
   <li>Session scoping for Application, SOAP, Transport and Request levels</li>
-</ol>
-
-<p id="head-5bb5aa099717d1d49642f7ae2d63ce5cf94487ad"><strong><em>Axis2
-Experimental Features List</em></strong></p>
-<ol type="1">
   <li>Server side &amp; client side Web service policy support</li>
   <li>?wsdl and ?xsd support</li>
   <li>Generating ServiceClient for a given WSDL and invoke the corresponding
     service using generated client.</li>
 </ol>
+<!--<p id="head-5bb5aa099717d1d49642f7ae2d63ce5cf94487ad"><strong><em>Axis2
+Experimental Features List</em></strong></p>
+<ol type="1">
+
+</ol>-->
 
 <h2>Axis2 Background and Motivation</h2>
 

Modified: webservices/axis2/trunk/java/xdocs/latest/index.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/index.html?rev=395490&r1=395489&r2=395490&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/index.html (original)
+++ webservices/axis2/trunk/java/xdocs/latest/index.html Wed Apr 19 22:32:05 2006
@@ -11,8 +11,10 @@
 
 <h2>Getting Started with Axis2</h2>
 <ul>
-  <li><a href="installationguide.html">Installation Guide</a></li>
-  <li><a href="userguide.html">User's Guide</a></li>
+  <li><a href="installationguide.html">Installation Guide</a> -Detailed
+    instructions on installation methods, information on system prerequisites
+    &amp; distribution packages.</li>
+  <li><a href="userguide.html">User's Guide</a> -</li>
   <li><a href="webadminguide.html">Web Administration Guide</a></li>
 </ul>
 
@@ -41,6 +43,9 @@
   <li><a href="security-module.html">WS-Security How-to</a></li>
   <li><a href="WS_policy.html">Web Services Policy Support In Axis2</a></li>
   <li><a href="soapmonitor-module.html">SOAP Monitor How-to</a></li>
+  <li><a href="tcp-transport.html">TCP Transport</a></li>
+  <li><a href="mail-transport.html">Mail Transport</a></li>
+  <li><a href="http-transport.html">HTTP Transports</a></li>
 </ul>
 
 <h2>Articles &amp; Tutorials</h2>
@@ -60,9 +65,7 @@
   <li><a
     href="http://jaxmag.com/itr/online_artikel/psecom,id,757,nodeid,147.html">Axis2
     Deployment Model</a></li>
-  <li><a
-    href="http://www.developer.com/open/article.php/3557741">Undertanding
-    Axis2 Deployment Architecture</a></li>
+  <li><a>Undertanding Axis2 Deployment Architecture</a></li>
   <li><a
     href="http://www.developer.com/java/other/article.php/3570031">Utilizing
     a Non-Java Web Servive with Axis2</a></li>

Modified: webservices/axis2/trunk/java/xdocs/latest/installationguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/installationguide.html?rev=395490&r1=395489&r2=395490&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/installationguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/latest/installationguide.html Wed Apr 19 22:32:05 2006
@@ -1,335 +1,347 @@
-<html>
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Axis2 Installation Guide</title>
-  <style type="text/css">
-  </style>
-</head>
-
-<body lang="en">
-<h1 align="center">Axis2 Installation Guide</h1>
-
-<p><i>Version 1.0</i></p>
-<i>Feedback: <a
-href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></i>
-
-<h3>Contents</h3>
-<ul>
-  <li><a href="#Download_Axis2">Download Axis2</a></li>
-  <li><p><a href="#requirements">System Requirements</a></p>
-  </li>
-  <li><a href="#_Toc96698083">Setting up the Environment and tools</a>
-    <ul>
-      <li><p><a href="#maven">Maven</a></p>
-      </li>
-      <li><a href="#_Toc96698085">The Axis2 source distribution</a></li>
-    </ul>
-  </li>
-  <li><p><a href="#_Toc96698086">Installing Axis2 in a Servlet
-    container</a></p>
-    <ul>
-      <li><a href="#upload">Uploading services</a></li>
-    </ul>
-  </li>
-</ul>
-<a name="Download_Axis2"></a>
-<h3>Download Axis2</h3>
-
-<p>Axis2 is distributed in several convenient distribution packages and can
-be installed either as a standalone server or as part of a J2EE compliant
-servlet container. Axis2 is distributed under the Apache License, version
-2.0. You can download Axis2 <a
-href="http://ws.apache.org/axis2/download.cgi">here</a>. Latest release of
-Axis2 is version 1.0.</p>
-
-<table width="940" border="1" cellpadding="1">
-  <tbody>
-    <tr>
-      <th width="83" scope="col">Distribution Name</th>
-      <th width="633" scope="col">Description</th>
-      <th width="202" scope="col">Items</th>
-    </tr>
-    <tr>
-      <td>Minimal Distribution - Binary</td>
-      <td>This distribution is aimed at advanced users who will be embedding
-        Axis2. It will contain the minimal runtime required to act as a Web
-        Service client and/or a server (axis2-core-1.0.jar will contain
-        compiled versions of common, xml, wsdl and core modules.)</td>
-      <td><ul>
-          <li>axis2-core-1.0.jar, axis2-adb-1.0.jar</li>
-          <li>third party distributable libraries</li>
-          <li>README.TXT and release-notes.html</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Minimal Distribution - Source</td>
-      <td background="#_Toc96698083"><p>This will contain the sources of
-        Axis2 minimal distribution. One can generate a binary distribution
-        from this by typing  <span class="style1">$maven dist-min-bin.
-        </span>(<a href="#_Toc96698083">Set up Axis2 environment</a> before
-        running this command)</p>
-      </td>
-      <td><ul>
-          <li>sources of Axis2 common, xml, wsdl, adb and core modules</li>
-          <li>README.TXT and release-notes.html</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Standard Distribution - Binary</td>
-      <td>This is the complete version of Axis2 and will contain useful
-        samples as well. Useful for some one to get familiar with Axis2.
-        (Since WS-Addressing implementation module is engaged in to Axis2, by
-        default, this distribution will contain addressing.mar. But  the
-        other modules that are being developed within Axis2 will not be
-        included here and are available to be downloaded separately from <a
-        href="http://ws.apache.org/axis2/modules/index.html">here</a>.)</td>
-      <td><ul>
-          <li>all the content of minimal-binary distribution</li>
-          <li>Contents of codegen and DOOM modules</li>
-          <li>Samples</li>
-          <li>addressing.mar</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Standard Distribution - Source</td>
-      <td>This will contain the sources of Axis2 standard distribution. One
-        can generate a binary distribution from this by typing <span
-        class="style1">$maven dist-standard-bin. </span>(<a
-        href="#_Toc96698083">Set up Axis2 environment</a> before running this
-        command)</td>
-      <td><ul>
-          <li>all the content of minimal-source distribution</li>
-          <li>Contents of codegen and DOOM modules</li>
-          <li>Samples</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>WAR (Web Archive) Distribution</td>
-      <td>This will be the web application of Axis2 which can be deployed in
-        most of the servlet containers.</td>
-      <td><ul>
-          <li>all the contents of the minimal distribution</li>
-          <li>Admin web app</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Documents Distribution</td>
-      <td>This will contain all the documentation in one package.</td>
-      <td><ul>
-          <li>xdocs</li>
-          <li>javadocs</li>
-        </ul>
-      </td>
-    </tr>
-    <tr>
-      <td>Plugin Distribution</td>
-      <td>This will contain the plugins that are created for Eclipse and
-      IDEA.</td>
-      <td><ul>
-          <li>Intellij IDEA plugins</li>
-          <li>Eclipse plugins</li>
-        </ul>
-      </td>
-    </tr>
-  </tbody>
-</table>
-<a name="requirements"></a>
-<h3>System Requirements</h3>
-
-<table border="2">
-  <caption></caption>
-  <tbody>
-    <tr>
-      <td>Java Runtime
-
-        <p>Environment</p>
-      </td>
-      <td>1.4 (It has not been fully tested on the latest JRE 1.5)
-
-        <p>For instructions on setting up the JRE in different operating
-        systems, visit <a
-        href="http://java.sun.com/">http://java.sun.com</a></p>
-      </td>
-    </tr>
-    <tr>
-      <td>Maven</td>
-      <td>1.0.2 or higher in Maven 1.x series (<a
-        href="http://maven.apache.org/">download</a>). <strong>Please
-        download maven 1.x version. Axis2 is not compatible with maven2
-        yet.</strong>
-
-        <p>Required only for building Axis2 from source distribution</p>
-      </td>
-    </tr>
-    <tr>
-      <td>Memory</td>
-      <td>No minimum requirement</td>
-    </tr>
-    <tr>
-      <td>Disk</td>
-      <td>No minimum requirement.
-
-        <p>Approximately 20 MB will be used for war distribution</p>
-      </td>
-    </tr>
-    <tr>
-      <td>Operating system</td>
-      <td>Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
-      Gentoo</td>
-    </tr>
-  </tbody>
-</table>
-
-
-<p>All the required jars are shipped with the binary distribution.</p>
-
-<p>Running the Maven build will automatically download the required jars when
-using source distribution.</p>
-<a name="_Toc96698083"></a>
-<h3>Setting up the Environment and Tools</h3>
-<a name="maven"></a>
-<h4>Maven</h4>
-
-<p>The Axis2 build is based on</p>
-<a href="http://maven.apache.org/maven-1.x/">Maven </a>. Hence the only
-prerequisite to build Axis2 from source distribution is to have Maven
-installed. Extensive instruction guides are available at the Maven site.This
-guide however 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>.
-<ul>
-  <li>Windows</li>
-</ul>
-<ol>
-  <li>Download and run the Windows installer package</li>
-  <li>Set the 'Environment Variables' ( create system variable MAVEN_HOME and
-    edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2";
-    path %MAVEN_HOME%\bin)</li>
-  <li>Make sure that system variable JAVA_HOME is set to the location of your
-    JDK, eg. C:\Program Files\Java\jdk1.5.0_02</li>
-  <li>Run maven --version to verify that it is correctly installed.</li>
-</ol>
-
-<p align="center"><img alt="clip_image002 (15K)"
-src="images/clip_image002.jpg" height="211" width="477"></p>
-<ul>
-  <li>Unix based OS (Linux etc)</li>
-</ul>
-
-<p>The tar ball or the zip archive is the best option. 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 you can start building Axis2.</p>
-<a name="_Toc96698085"></a>
-
-<h4>The Axis2 source distribution</h4>
-
-<p>The <a href="http://ws.apache.org/axis2/download.cgi">source distribution
-</a> is available as a zipped archive. 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 running
-maven command will build the Axis2 jar file.</p>
-
-<p align="center"><img alt="clip_image004 (43K)" src="images/maven.jpg"/><br clear="all"/></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>
-<a name="_Toc96698086"></a>
-
-<h3>Installing Axis2 in a Servlet container</h3>
-<ol>
-  <li><a href="http://ws.apache.org/axis2/download.cgi">Download</a> Axis2 war file</li>
-  <li>Drop the war in the webapps folder. Most servlet containers will
-    automatically install war. (some servlet containers may require a restart
-    in order to capture the new web application. Refer your servlet container
-    documentation for more information about this.)</li>
-  <li>Once the WAR is successfully installed, test it by pointing the web
-    browser to the <strong>http:// &lt;host :port&gt;/ axis2. </strong>It
-    should produce the following page which is the <strong>Axis2 Web
-    Application Home Page</strong>.</li>
-
-  <p align="center"><strong><img src="images/clip_image006.jpg"
-  alt=""></strong></p>
-
-  <p></p>
-  <li>Use validate link to ensure that everything is fine and smooth. If the
-    validation fails then the war has failed to install properly or some
-    essential jars are missing. At such a situation the documentation of the
-    particular servlet container should be consulted to find the problem. The
-    following page is a successful validation. Note the statement core Axis2
-    libraries are present.
-    <p></p>
-  </li>
-
-  <p align="center"><strong><img src="images/happyaxis.jpg"
-  alt=""></strong></p>
-</ol>
-<a name="upload"></a>
-<h4>Uploading services</h4>
-<ol>
-  <p>The Axis2 web application also provides an interface to upload services.
-  Once a service is created according to the service specification as
-  described in userguide that jar file can be uploaded using the upload
-  page.</p>
-
-  <p align="center"><strong><img src="images/clip_image010.jpg"
-  alt=""></strong></p>
-
-  <p>The uploaded jar files will be stored in the default service directory.
-  For Axis2 this will be the &lt;webapps&gt;/axis2/WEB-INF/services
-  directory. Once a service is uploaded it will be installed instantly.</p>
-
-  <p>Since Axis2 supports hot deployment one can drop the service jar
-  directly through the file system to the above mentioned services
-  directory.It will also cause the service to be automatically installed
-  without the container being restarted.</p>
-
-  <p>Use the 'Services' link on the Web Application home page to check the
-  successful installation of a service. 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" alt=""></p>
-
-  <p></p>
-
-  <p>If the service has deployment time error it will list those services as
-  faulty services. If you click on the link you can see the your deployment
-  fault error message(s).</p>
-
-  <p align="center"><img src="images/faultservice.jpg" alt=""></p>
-
-  <p>Deployment time error message</p>
-
-  <p align="center"><strong><img src="images/faultmsg.jpg"
-  alt=""></strong></p>
-
-  <p></p>
-
-  <p>Axis2 Administration is all about configuring Axis2 at the run time and
-  the configuration will be transient. More descriptions are available in <a
-  href="webadminguide.html">Axis2 Web Administration Guide</a></p>
-</ol>
-</body>
-</html>
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Axis2 Installation Guide</title>
+  <style type="text/css">
+  </style>
+</head>
+
+<body lang="en">
+<h1 align="center">Apache Axis2 Installation Guide</h1>
+
+<p><i>-Axis2 Version 1.0</i></p>
+
+<p>This document will give you information on Axis2 distribution packages,
+system prerequisites &amp; setting up environment variables and tools
+followed by detailed instructions on installation methods.</p>
+
+<p><i>Send your feedback to: <a
+href="mailto:axis-dev@ws.apache.org">axis-dev@ws.apache.org</a></i>. Prefix subject with [Axis2]. To subscribe to mailing list see <a href="http://ws.apache.org/axis2/mail-lists.html">here.</a></p>
+
+<h3>Contents</h3>
+<ul>
+  <li><a href="#Download_Axis2">Download Axis2</a></li>
+  <li><p><a href="#requirements">System Requirements</a></p>
+  </li>
+  <li><a href="#_Toc96698083">Setting up the Environment and tools</a>
+    <ul>
+      <li><p><a href="#maven">Maven</a></p>
+      </li>
+      <li><a href="#_Toc96698085">The Axis2 source distribution</a></li>
+    </ul>
+  </li>
+  <li><p><a href="#_Toc96698086">Installing Axis2 in a Servlet
+    container</a></p>
+    <ul>
+      <li><a href="#upload">Uploading services</a></li>
+    </ul>
+  </li>
+</ul>
+<a name="Download_Axis2"></a>
+
+<h3>Download Axis2</h3>
+
+<p>Axis2 is distributed in several convenient distribution packages and can
+be installed either as a standalone server or as part of a J2EE compliant
+servlet container. Axis2 is distributed under the Apache License, version
+2.0. You can download Axis2 <a
+href="http://ws.apache.org/axis2/download.cgi">here</a>. Latest release of
+Axis2 is version 1.0.</p>
+
+<table width="940" border="1" cellpadding="1">
+  <tbody>
+    <tr>
+      <th width="83" scope="col">Distribution Name</th>
+      <th width="633" scope="col">Description</th>
+      <th width="202" scope="col">Items</th>
+    </tr>
+    <tr>
+      <td>Minimal Distribution - Binary</td>
+      <td>This distribution is aimed at advanced users who will be embedding
+        Axis2. It will contain the minimal runtime required to act as a Web
+        Service client and/or a server (axis2-core-1.0.jar will contain
+        compiled versions of common, xml, wsdl and core modules.)</td>
+      <td><ul>
+          <li>axis2-core-1.0.jar, axis2-adb-1.0.jar</li>
+          <li>third party distributable libraries</li>
+          <li>README.TXT and release-notes.html</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>Minimal Distribution - Source</td>
+      <td background="#_Toc96698083"><p>This will contain the sources of
+        Axis2 minimal distribution. One can generate a binary distribution
+        from this by typing  <span class="style1">$maven dist-min-bin.
+        </span>(<a href="#_Toc96698083">Set up Axis2 environment</a> before
+        running this command)</p>
+      </td>
+      <td><ul>
+          <li>sources of Axis2 common, xml, wsdl, adb and core modules</li>
+          <li>README.TXT and release-notes.html</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>Standard Distribution - Binary</td>
+      <td>This is the complete version of Axis2 and will contain useful
+        samples as well. Useful for some one to get familiar with Axis2.
+        (Since WS-Addressing implementation module is engaged in to Axis2, by
+        default, this distribution will contain addressing.mar. But  the
+        other modules that are being developed within Axis2 will not be
+        included here and are available to be downloaded separately from <a
+        href="http://ws.apache.org/axis2/modules/index.html">here</a>.)</td>
+      <td><ul>
+          <li>all the content of minimal-binary distribution</li>
+          <li>Contents of codegen and DOOM modules</li>
+          <li>Samples</li>
+          <li>addressing.mar</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>Standard Distribution - Source</td>
+      <td>This will contain the sources of Axis2 standard distribution. One
+        can generate a binary distribution from this by typing <span
+        class="style1">$maven dist-standard-bin. </span>(<a
+        href="#_Toc96698083">Set up Axis2 environment</a> before running this
+        command)</td>
+      <td><ul>
+          <li>all the content of minimal-source distribution</li>
+          <li>Contents of codegen and DOOM modules</li>
+          <li>Samples</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>WAR (Web Archive) Distribution</td>
+      <td>This will be the web application of Axis2 which can be deployed in
+        most of the servlet containers.</td>
+      <td><ul>
+          <li>all the contents of the minimal distribution</li>
+          <li>Admin web app</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>Documents Distribution</td>
+      <td>This will contain all the documentation in one package.</td>
+      <td><ul>
+          <li>xdocs</li>
+          <li>javadocs</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>Plugin Distribution</td>
+      <td>This will contain the plugins that are created for Eclipse and
+      IDEA.</td>
+      <td><ul>
+          <li>Intellij IDEA plugins</li>
+          <li>Eclipse plugins</li>
+        </ul>
+      </td>
+    </tr>
+  </tbody>
+</table>
+<a name="requirements"></a>
+
+<h3>System Requirements</h3>
+
+<table border="2">
+  <caption></caption>
+  <tbody>
+    <tr>
+      <td>Java Runtime
+
+        <p>Environment</p>
+      </td>
+      <td>1.4 (It has not been fully tested on the latest JRE 1.5)
+
+        <p>For instructions on setting up the JRE in different operating
+        systems, visit <a
+        href="http://java.sun.com/">http://java.sun.com</a></p>
+      </td>
+    </tr>
+    <tr>
+      <td>Maven</td>
+      <td>1.0.2 or higher in Maven 1.x series (<a
+        href="http://maven.apache.org/">download</a>). <strong>Please
+        download maven 1.x version. Axis2 is not compatible with maven2
+        yet.</strong>
+
+        <p>Required only for building Axis2 from source distribution</p>
+      </td>
+    </tr>
+    <tr>
+      <td>Memory</td>
+      <td>No minimum requirement</td>
+    </tr>
+    <tr>
+      <td>Disk</td>
+      <td>No minimum requirement.
+
+        <p>Approximately 20 MB will be used for war distribution</p>
+      </td>
+    </tr>
+    <tr>
+      <td>Operating system</td>
+      <td>Tested on Windows XP, Linux, Mac OS X, Fedora core, Ubuntu,
+      Gentoo</td>
+    </tr>
+  </tbody>
+</table>
+
+<p>All the required jars are shipped with the binary distribution.</p>
+
+<p>Running the Maven build will automatically download the required jars when
+using source distribution.</p>
+<a name="_Toc96698083"></a>
+
+<h3>Setting up the Environment and Tools</h3>
+<a name="maven"></a>
+
+<h4>Maven</h4>
+
+<p>The Axis2 build is based on</p>
+<a href="http://maven.apache.org/maven-1.x/">Maven </a>. Hence the only
+prerequisite to build Axis2 from source distribution is to have Maven
+installed. Extensive instruction guides are available at the Maven site.This
+guide however 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>.
+<ul>
+  <li>Windows</li>
+</ul>
+<ol>
+  <li>Download and run the Windows installer package</li>
+  <li>Set the 'Environment Variables' ( create system variable MAVEN_HOME and
+    edit path. eg: "C:\Program Files\Apache Software Foundation\maven-1.0.2";
+    path %MAVEN_HOME%\bin)</li>
+  <li>Make sure that system variable JAVA_HOME is set to the location of your
+    JDK, eg. C:\Program Files\Java\jdk1.5.0_02</li>
+  <li>Run maven --version to verify that it is correctly installed.</li>
+</ol>
+
+<p align="center"><img alt="clip_image002 (15K)"
+src="images/clip_image002.jpg" height="211" width="477"></p>
+<ul>
+  <li>Unix based OS (Linux etc)</li>
+</ul>
+
+<p>The tar ball or the zip archive is the best option. 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 you can start building Axis2.</p>
+<a name="_Toc96698085"></a>
+
+<h4>The Axis2 source distribution</h4>
+
+<p>The <a href="http://ws.apache.org/axis2/download.cgi">source distribution
+</a> is available as a zipped archive. 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 running
+maven command will build the Axis2 jar file.</p>
+
+<p align="center"><img alt="clip_image004 (43K)" src="images/maven.jpg"><br
+clear="all">
+</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>
+<a name="_Toc96698086"></a>
+
+<h3>Installing Axis2 in a Servlet container</h3>
+<ol>
+  <li><a href="http://ws.apache.org/axis2/download.cgi">Download</a> Axis2
+    war file</li>
+  <li>Drop the war in the webapps folder. Most servlet containers will
+    automatically install war. (some servlet containers may require a restart
+    in order to capture the new web application. Refer your servlet container
+    documentation for more information about this.)</li>
+  <li>Once the WAR is successfully installed, test it by pointing the web
+    browser to the <strong>http:// &lt;host :port&gt;/ axis2. </strong>It
+    should produce the following page which is the <strong>Axis2 Web
+    Application Home Page</strong>.</li>
+
+  <p align="center"><strong><img src="images/clip_image006.jpg"
+  alt=""></strong></p>
+
+  <p></p>
+  <li>Use validate link to ensure that everything is fine and smooth. If the
+    validation fails then the war has failed to install properly or some
+    essential jars are missing. At such a situation the documentation of the
+    particular servlet container should be consulted to find the problem. The
+    following page is a successful validation. Note the statement core Axis2
+    libraries are present.
+    <p></p>
+  </li>
+
+  <p align="center"><strong><img src="images/happyaxis.jpg"
+  alt=""></strong></p>
+</ol>
+<a name="upload"></a>
+
+<h4>Uploading services</h4>
+<ol>
+  <p>The Axis2 web application also provides an interface to upload services.
+  Once a service is created according to the service specification as
+  described in userguide that jar file can be uploaded using the upload
+  page.</p>
+
+  <p align="center"><strong><img src="images/clip_image010.jpg"
+  alt=""></strong></p>
+
+  <p>The uploaded jar files will be stored in the default service directory.
+  For Axis2 this will be the &lt;webapps&gt;/axis2/WEB-INF/services
+  directory. Once a service is uploaded it will be installed instantly.</p>
+
+  <p>Since Axis2 supports hot deployment one can drop the service jar
+  directly through the file system to the above mentioned services
+  directory.It will also cause the service to be automatically installed
+  without the container being restarted.</p>
+
+  <p>Use the 'Services' link on the Web Application home page to check the
+  successful installation of a service. 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" alt=""></p>
+
+  <p></p>
+
+  <p>If the service has deployment time error it will list those services as
+  faulty services. If you click on the link you can see the your deployment
+  fault error message(s).</p>
+
+  <p align="center"><img src="images/faultservice.jpg" alt=""></p>
+
+  <p>Deployment time error message</p>
+
+  <p align="center"><strong><img src="images/faultmsg.jpg"
+  alt=""></strong></p>
+
+  <p></p>
+
+  <p>Axis2 Administration is all about configuring Axis2 at the run time and
+  the configuration will be transient. More descriptions are available in <a
+  href="webadminguide.html">Axis2 Web Administration Guide</a></p>
+</ol>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/latest/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/userguide.html?rev=395490&r1=395489&r2=395490&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/userguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/latest/userguide.html Wed Apr 19 22:32:05 2006
@@ -1,183 +1,191 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Axis2 User's Guide</title>
-</head>
-
-<body lang="en-US" dir="ltr">
-<h1 align="center"><a name="_Toc96697849" id="_Toc96697849"></a>Axis2 User's
-Guide</h1>
-
-<p><i>Version 1.0</i></p>
-
-<p align="right">Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a
-href="userguide3.html">3</a>, <a href="userguide4.html">4</a>, <a href="userguide5.html" >5</a></p>
-
-<h2>Content</h2>
-<ul>
-  <li><p><a href="userguide1.html#Axis2_User's_Guide">Introduction</a></p>
-    <ul>
-      <li><a href="userguide1.html#Attention">Attention</a></li>
-      <li><a href="userguide1.html#What_is_Axis2_">What is Axis2?</a></li>
-      <li><a href="userguide1.html#Axis2_Complete_Features_List">Axis2
-        Complete Features List</a>
-        <ul>
-          <li><a
-            href="userguide1.html#Experimental_Features_List">Experimental
-            Features List</a></li>
-          <li><a
-            href="userguide1.html#Major_Changes_Since_Last_Release">Major
-            Changes Since Last Release</a></li>
-        </ul>
-      </li>
-      <li><a href="userguide1.html#Tools_included_in this_Release">Tools
-        included in this Release</a></li>
-      <li><a href="userguide1.html#What's_still_to_do_">What's still to
-        do?</a></li>
-    </ul>
-  </li>
-  <li><p><a href="userguide2.html#Axis2_User's_Guide">Web Services Using
-    Axis2</a></p>
-    <ul>
-      <li><a
-        href="userguide2.html#Writing_Web_Services_Using Axis2's_Primary_APIs">Writing
-        Web Services using Axis2 APIs</a>
-        <ul>
-          <li><a
-            href="userguide2.html#Creating_Web_Service__MyService_">Creating
-            Web Service (MyService)</a></li>
-          <li><a href="userguide2.html#How_to_write_the_Web_Service_">How to
-            write the Web Service?</a>
-            <ul>
-              <li><a
-                href="userguide2.html#Step1_:Write_the_Implementation_Class">Step1
-                :Write the Implementation Class</a></li>
-              <li><a
-                href="userguide2.html#Step2_:Write_the_services_xml_file">Step2
-                :Write the services.xml file</a></li>
-              <li><a
-                href="userguide2.html#Step3_:Create_the_Web_Service_Archive">Step3
-                :Create the Web Service Archive</a></li>
-              <li><a
-                href="userguide2.html#Step4_:Deploy_the_Web_Service">Step4
-                :Deploy the Web Service</a></li>
-            </ul>
-          </li>
-        </ul>
-      </li>
-      <li><p><a
-        href="userguide2.html#Writing_Web_Services_by_Code_Generating_Skeleton">Writing
-        Web Services by Code Generating Skeleton</a></p>
-        <ul>
-          <li><a href="userguide2.html#WSDL2Java_Tool">WSDL2Java Tool</a></li>
-          <li><a
-            href="userguide2.html#Implement_the_Business_Logic">Implement the
-            Business Logic</a></li>
-          <li><a href="userguide2.html#echoString">echoString</a></li>
-          <li><a
-          href="userguide2.html#echoStringArray">echoStringArray</a></li>
-          <li><a href="userguide2.html#echoStruct">echoStruct</a></li>
-          <li><a href="userguide2.html#services_xml">services.xml</a></li>
-          <li><a href="userguide2.html#Packaging">Packaging</a></li>
-        </ul>
-      </li>
-    </ul>
-  </li>
-</ul>
-<ul>
-  <li><p><a href="userguide3.html#Axis2_User's_Guide">Web Service Clients
-    Using Axis2</a></p>
-    <ul>
-      <li><a
-        href="userguide3.html#Writing_Web_Service_Clients_using_Axis2's_Primary_APIs">Writing
-        Web Service Clients using Axis2's Primary APIs</a>
-        <ul>
-          <li><a
-            href="userguide3.html#EchoBlockingClient">EchoBlockingClient</a></li>
-          <li><a href="userguide3.html#PingClient">PingClient</a></li>
-          <li><a
-            href="userguide3.html#EchoNonBlockingClient">EchoNonBlockingClient</a></li>
-          <li><a
-            href="userguide3.html#EchoNonBlockingDualClient">EchoNonBlockingDualClient</a></li>
-          <li><a
-            href="userguide3.html#EchoBlockingDualClient">EchoBlockingDualClient</a></li>
-        </ul>
-      </li>
-      <li><p><a
-        href="userguide3.html#Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support">Writing
-        Web Service Clients using Code Generation with Data Binding
-        Support</a></p>
-        <ul>
-          <li><a href="userguide3.html#Client_for_echoVoid_Operation">Client
-            for echoVoid Operation</a></li>
-          <li><a
-            href="userguide3.html#Client_for_echoString_Operation">Client for
-            echoString Operation</a></li>
-          <li><a href="userguide3.html#Client_for_echoStringArray_Operation">Cient for
-            echoStringArray Operation</a></li>
-          <li><a
-            href="userguide3.html#Client_for_echoStruct_Operation">Client for
-            echoStruct Operation</a></li>
-        </ul>
-      </li>
-    </ul>
-  </li>
-  <li><p><a href="userguide4.html#Axis2_User's_Guide">Modules</a></p>
-    <ul>
-      <li><a href="userguide4.html#MyService_with_a_Logging_Module">MyService
-        with a Logging Module</a>
-        <ul>
-          <li><a href="userguide4.html#Step1_:_LoggingModule_Class">Step1 :
-            LoggingModule Class</a></li>
-          <li><a href="userguide4.html#Step2_:_LogHandler">Step2 :
-            LogHandler</a></li>
-          <li><a href="userguide4.html#Step3_:_module_xml">Step3 :
-            module.xml</a></li>
-          <li><a
-            href="userguide4.html#Step_4:_Modify_the_&quot;axis2_xml&quot;">Step
-            4: Modify the "axis2.xml"</a></li>
-          <li><a
-            href="userguide4.html#Step5_:_Modify_the_&quot;services_xml&quot;">Step5
-            : Modify the "services.xml"</a></li>
-          <li><a href="userguide4.html#Step6_:_Packaging">Step6 :
-            Packaging</a></li>
-          <li><a
-            href="userguide4.html#Step7_:_Deploy_the_Module_in_Axis2">Step7 :
-            Deploy the Module in Axis2</a></li>
-        </ul>
-      </li>
-    </ul>
-  </li>
-  <li><p><a href="userguide5.html#Axis2_User's_Guide">Other Samples</a></p>
-    <ul>
-      <li><a href="userguide5.html#Google_Spell_Checker_Sample">Google Spell
-        Checker Sample</a></li>
-      <li><a href="userguide5.html#Google_Search_Sample">Google Search
-        Sample</a></li>
-      <li><a href="userguide5.html#Amazon_Queuing_Service">Amazon Queuing
-        Service</a></li>
-    </ul>
-  </li>
-  <li><p>Advanced Topics</p>
-    <ul>
-      <li><a href="rest-ws.html" target="_blank">RESTful Web Services</a></li>
-      <li><a href="tcp-transport.html" target="_blank">TCP transport</a></li>
-      <li><a href="mail-transport.html" target="_blank">Mail
-      Transport</a></li>
-      <li><a href="http-transport.html" target="_blank">HTTP
-      Transports</a></li>
-      <li><a href="mtom-guide.html" target="_blank">MTOM with Axis2</a></li>
-      <li><a href="security-module.html" target="_blank">Securing SOAP
-        Messages with WSS4J</a></li>
-    </ul>
-  </li>
-</ul>
-
-<p align="right"><a href="userguide1.html">Next Page <img
-src="images/arrow_right.gif"></a></p>
-
-<p>Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a>, <a href="userguide4.html">4</a>, <a
-href="userguide5.html">5</a></p>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Axis2 User's Guide</title>
+</head>
+
+<body lang="en-US" dir="ltr">
+<h1 align="center"><a name="_Toc96697849" id="_Toc96697849">Apache</a> Axis2
+User's Guide</h1>
+
+<p><i>-Axis2 Version 1.0</i></p>
+
+<p>This document mainly contains data on how to write Web services &amp; Web
+service clients using Axis2, also creating a custom module and deploying it
+to a Web service. Samples shipped with the binary distribution of Axis2 is
+also described here. </p>
+
+<p align="right">Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a
+href="userguide2.html">2</a>, <a href="userguide3.html">3</a>, <a
+href="userguide4.html">4</a>, <a href="userguide5.html">5</a></p>
+
+<h2>Content</h2>
+<ul>
+  <li><p><a href="userguide1.html#Axis2_User's_Guide">Introduction</a></p>
+    <ul>
+      <li><a href="userguide1.html#Attention">Attention</a></li>
+      <li><a href="userguide1.html#What_is_Axis2_">What is Axis2?</a></li>
+      <li><a href="userguide1.html#Axis2_Complete_Features_List">Axis2
+        Complete Features List</a>
+        <ul>
+          <li><a
+            href="userguide1.html#Experimental_Features_List">Experimental
+            Features List</a></li>
+          <li><a
+            href="userguide1.html#Major_Changes_Since_Last_Release">Major
+            Changes Since Last Release</a></li>
+        </ul>
+      </li>
+      <li><a href="userguide1.html#Tools_included_in this_Release">Tools
+        included in this Release</a></li>
+      <li><a href="userguide1.html#What's_still_to_do_">What's still to
+        do?</a></li>
+    </ul>
+  </li>
+  <li><p><a href="userguide2.html#Axis2_User's_Guide">Web Services Using
+    Axis2</a></p>
+    <ul>
+      <li><a
+        href="userguide2.html#Writing_Web_Services_Using Axis2's_Primary_APIs">Writing
+        Web Services using Axis2 APIs</a>
+        <ul>
+          <li><a
+            href="userguide2.html#Creating_Web_Service__MyService_">Creating
+            Web Service (MyService)</a></li>
+          <li><a href="userguide2.html#How_to_write_the_Web_Service_">How to
+            write the Web Service?</a>
+            <ul>
+              <li><a
+                href="userguide2.html#Step1_:Write_the_Implementation_Class">Step1
+                :Write the Implementation Class</a></li>
+              <li><a
+                href="userguide2.html#Step2_:Write_the_services_xml_file">Step2
+                :Write the services.xml file</a></li>
+              <li><a
+                href="userguide2.html#Step3_:Create_the_Web_Service_Archive">Step3
+                :Create the Web Service Archive</a></li>
+              <li><a
+                href="userguide2.html#Step4_:Deploy_the_Web_Service">Step4
+                :Deploy the Web Service</a></li>
+            </ul>
+          </li>
+        </ul>
+      </li>
+      <li><p><a
+        href="userguide2.html#Writing_Web_Services_by_Code_Generating_Skeleton">Writing
+        Web Services by Code Generating Skeleton</a></p>
+        <ul>
+          <li><a href="userguide2.html#WSDL2Java_Tool">WSDL2Java Tool</a></li>
+          <li><a
+            href="userguide2.html#Implement_the_Business_Logic">Implement the
+            Business Logic</a></li>
+          <li><a href="userguide2.html#echoString">echoString</a></li>
+          <li><a
+          href="userguide2.html#echoStringArray">echoStringArray</a></li>
+          <li><a href="userguide2.html#echoStruct">echoStruct</a></li>
+          <li><a href="userguide2.html#services_xml">services.xml</a></li>
+          <li><a href="userguide2.html#Packaging">Packaging</a></li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+</ul>
+<ul>
+  <li><p><a href="userguide3.html#Axis2_User's_Guide">Web Service Clients
+    Using Axis2</a></p>
+    <ul>
+      <li><a
+        href="userguide3.html#Writing_Web_Service_Clients_using_Axis2's_Primary_APIs">Writing
+        Web Service Clients using Axis2's Primary APIs</a>
+        <ul>
+          <li><a
+            href="userguide3.html#EchoBlockingClient">EchoBlockingClient</a></li>
+          <li><a href="userguide3.html#PingClient">PingClient</a></li>
+          <li><a
+            href="userguide3.html#EchoNonBlockingClient">EchoNonBlockingClient</a></li>
+          <li><a
+            href="userguide3.html#EchoNonBlockingDualClient">EchoNonBlockingDualClient</a></li>
+          <li><a
+            href="userguide3.html#EchoBlockingDualClient">EchoBlockingDualClient</a></li>
+        </ul>
+      </li>
+      <li><p><a
+        href="userguide3.html#Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support">Writing
+        Web Service Clients using Code Generation with Data Binding
+        Support</a></p>
+        <ul>
+          <li><a href="userguide3.html#Client_for_echoVoid_Operation">Client
+            for echoVoid Operation</a></li>
+          <li><a
+            href="userguide3.html#Client_for_echoString_Operation">Client for
+            echoString Operation</a></li>
+          <li><a
+            href="userguide3.html#Client_for_echoStringArray_Operation">Cient
+            for echoStringArray Operation</a></li>
+          <li><a
+            href="userguide3.html#Client_for_echoStruct_Operation">Client for
+            echoStruct Operation</a></li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+  <li><p><a href="userguide4.html#Axis2_User's_Guide">Modules</a></p>
+    <ul>
+      <li><a href="userguide4.html#MyService_with_a_Logging_Module">MyService
+        with a Logging Module</a>
+        <ul>
+          <li><a href="userguide4.html#Step1_:_LoggingModule_Class">Step1 :
+            LoggingModule Class</a></li>
+          <li><a href="userguide4.html#Step2_:_LogHandler">Step2 :
+            LogHandler</a></li>
+          <li><a href="userguide4.html#Step3_:_module_xml">Step3 :
+            module.xml</a></li>
+          <li><a
+            href="userguide4.html#Step_4:_Modify_the_&quot;axis2_xml&quot;">Step
+            4: Modify the "axis2.xml"</a></li>
+          <li><a
+            href="userguide4.html#Step5_:_Modify_the_&quot;services_xml&quot;">Step5
+            : Modify the "services.xml"</a></li>
+          <li><a href="userguide4.html#Step6_:_Packaging">Step6 :
+            Packaging</a></li>
+          <li><a
+            href="userguide4.html#Step7_:_Deploy_the_Module_in_Axis2">Step7 :
+            Deploy the Module in Axis2</a></li>
+        </ul>
+      </li>
+    </ul>
+  </li>
+  <li><p><a href="userguide5.html#Axis2_User's_Guide">Other Samples</a></p>
+    <ul>
+      <li><a href="userguide5.html#Google_Spell_Checker_Sample">Google Spell
+        Checker Sample</a></li>
+      <li><a href="userguide5.html#Google_Search_Sample">Google Search
+        Sample</a></li>
+      <li><a href="userguide5.html#Amazon_Queuing_Service">Amazon Queuing
+        Service</a></li>
+    </ul>
+  </li>
+  <li><p>Advanced Topics</p>
+    <ul>
+      <li><a href="rest-ws.html" target="_blank">RESTful Web Services</a></li>
+      <li><a href="tcp-transport.html" target="_blank">TCP transport</a></li>
+      <li><a href="mail-transport.html" target="_blank">Mail
+      Transport</a></li>
+      <li><a href="http-transport.html" target="_blank">HTTP
+      Transports</a></li>
+      <li><a href="mtom-guide.html" target="_blank">MTOM with Axis2</a></li>
+      <li><a href="security-module.html" target="_blank">Securing SOAP
+        Messages with WSS4J</a></li>
+    </ul>
+  </li>
+</ul>
+
+<p align="right"><a href="userguide1.html">Next Page <img
+src="images/arrow_right.gif"></a></p>
+
+<p>Pages: <b>Content</b>, <a href="userguide1.html">1</a>, <a
+href="userguide2.html">2</a>, <a href="userguide3.html">3</a>, <a
+href="userguide4.html">4</a>, <a href="userguide5.html">5</a></p>
+</body>
+</html>

Modified: webservices/axis2/trunk/java/xdocs/latest/userguide1.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/latest/userguide1.html?rev=395490&r1=395489&r2=395490&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/latest/userguide1.html (original)
+++ webservices/axis2/trunk/java/xdocs/latest/userguide1.html Wed Apr 19 22:32:05 2006
@@ -1,228 +1,230 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<html>
-<head>
-  <meta http-equiv="content-type" content="">
-  <title>Axis2 User's Guide</title>
-</head>
-
-<body lang="en-US" dir="ltr">
-<h4><a name="Axis2_User's_Guide">Axis2 User's Guide</a></h4>
-
-<p><i>Version 1.0</i></p>
-<i>User Feedback: <a
-href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a></i>
-
-<p align="right">Pages: <a href="userguide.html">Content</a>, <b>1</b>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a>, <a
-href="userguide4.html">4</a>, <a href="userguide5.html">5</a></p>
-
-<h2><a name="Introduction">Introduction</a></h2>
-
-<p>Welcome to Axis2, the next generation of Apache Axis!!! This User's Guide
-will help you to understand what Axis2 has to offer and how to get started
-with it. We hope you will benefit from the power of Axis2.</p>
-
-<h3><a name="Attention">Attention</a></h3>
-<ul>
-  <li><p style="margin-bottom: 0in">This User's Guide is written based on
-    Axis2 standard binary distribution. (The standard binary distribution can
-    be created from the source distribution using the maven goal <code>$maven
-    dist-std-bin</code>). Please refer the <a
-    href="installationguide.html#Download_Axis2">installation guide</a> for further
-    information on the downloadables available in this release.</p>
-  </li>
-  <li><p>If you are new to Axis, it's highly recommended that you read <a
-    href="http://ws.apache.org/axis/java/user-guide.html" target="_blank">Axis 1.x User's
-    Guide</a> before you go any further in this guide.</p>
-  </li>
-</ul>
-
-<h3><a name="What_is_Axis2_">What is Axis2?</a></h3>
-
-<p>Axis2 is the next generation of Apache Axis. In late August 2004, during
-the Axis2 Summit held in Colombo, Sri Lanka, a new architecture for Axis was
-introduced which was much more flexible, efficient and configurable. Although
-the architecture is new, some of the well established concepts from Axis 1.x
-like handlers are preserved in Axis2. Axis2 comes with many new features,
-enhancements and industry specification implementations.</p>
-
-<p>After months of continued discussion and coding in this direction, Axis2
-now delivers the following key features:</p>
-<ul>
-  <li><p style="margin-bottom: 0in"><strong>Speed</strong> - Axis2 uses its
-    own object model and StAX (Streaming API for XML) parsing to achieve
-    significantly greater speed than earlier versions of Apache Axis.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Low memory foot print</strong>-
-    Axis2 was designed ground-up keeping low memory foot print in mind.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>AXIOM</strong> - Axis2 comes with
-    its own light-weight object model, AXIOM, for message processing which is
-    extensible, high performance and developer convenient</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong><a name="Hot_Deployment">Hot
-    Deployment</a></strong> - Axis2 is equipped with the capability of
-    deploying web service &amp; handlers while system is up and running. In
-    other words, new services can be added to the system without having to
-    shut down server.Drop the required Web service archive into the services
-    directory in the repository and deployment model will automatically
-    deploy the service and make it available for use.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Asynchronous Web
-    Services</strong> - Axis2 now supports asynchronous web services &amp;
-    asynchronous web services invocation using non-blocking clients and
-    transports .</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2 now
-    comes handy with the flexibility to support Message Exchange Patterns
-    (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Flexibility</strong> - The Axis2
-    architecture gives the developer complete freedom to insert extensions
-    into the engine for custom header processing, system management, or
-    <em>anything else you can imagine</em>.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Stability</strong> - Axis2
-    defines a set of published interfaces which change relatively slowly
-    compared to the rest of Axis.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Component-oriented
-    Deployment</strong> - You can easily define reusable networks of Handlers
-    to implement common patterns of processing for your applications, or to
-    distribute to partners.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Transport Framework</strong> - We
-    have a clean and simple abstraction for integrating and using Transports
-    (i.e., senders and listeners for SOAP over various protocols such as
-    SMTP, FTP, message-oriented middleware, etc), and the core of the engine
-    is completely transport-independent.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
-    supports the <a href="http://www.w3.org/TR/wsdl" target="_blank">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 Axis2.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Add-ons</strong> Several web
-    services specifications have been incorporated including <a
-    href="http://ws.apache.org/wss4j/" target="_blank">WSS4J</a> for security, <a
-    href="http://ws.apache.org/sandesha/" target="_blank">Sandesha</a> for reliable
-    messaging, <a href="http://ws.apache.org/kandula/" target="_blank">Kandula</a> which is
-    an encapsulation of WS-Coordination, WS-AtomicTransaction and
-    WS-BusinessActivity.</p>
-  </li>
-  <li><p style="margin-bottom: 0in"><strong>Composition and
-    Extensibility</strong> - modules and phases improve support for
-    composability and extensibility. Modules supports composability and is
-    able to add support for new WS-* specifications in a simple and clean
-    manner. They are however not <a href="#Hot_Deployment">hot deployable</a>
-    as they change the overall behavior of the system.</p>
-  </li>
-</ul>
-
-<p>We hope you enjoy using Axis2. 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 us a hand! The Axis developer community welcomes your
-participation.</p>
-
-<p>Let us know what you think!</p>
-
-<p>Please send your feedback on Axis2 to "<a
-href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a>" and make
-sure to prefix the subject of the mail with [Axis2].</p>
-
-<h3><a name="Axis2_Complete_Features_List">Axis2 Complete Features
-List</a></h3>
-<ol type="1"> 
- <li>AXIOM, an XML object model working on StAX (Streaming API for XML) parsing optimized for SOAP 1.1/1.2 Messages. This has complete XML infoset support.</li>
- <li>Support for One-Way Messaging (In-Only) and Request Response Messaging (In-Out)</li>
- <li>Module Architecture, mechanism to extend the SOAP Processing Model</li>
- <li>Module version support , can have multiple versions of the same module and use them depending on the requirement.</li>
- <li>Content hierarchy</li>
- <li>Archive based deployment Model and Directory based deployment model</li>
- <li>JWS like deployment (making Java class into Web service)</li>
- <li>WSDL Code Generation Tool for Stub and skeletons</li>
- <li>WS-Addressing, both the submission (2004/08) and final (2005/08) versions</li>
- <li>WSS4J module for security</li>
- <li>Improved and user friendly Client API</li>
- <li>WSDL2Java and Java2WSDL</li>
- <li>REST (REpresentational State Transfer) Support</li>
- <li>Transports supports: HTTP, SMTP, TCP, JMS</li>
- <li>Raw XML providers</li>
- <li>Support for MTOM/ MIME/ SwA</li>
- <li>SAAJ implementation</li>
- <li>DOOM</li>
- <li>Pack/Unpack capability for the generated code</li>
- <li>Axis Data Binding - ADB (Framework and Schema Compiler)</li>
- <li>Numerous bug fixes since last release</li>
- <li>Transport framework improvements (ListenerManager)- <span style="color: #FF0000">New</span></li>
- <li>AxisServlet auto start when application server get start up- <span style="color: #FF0000">New</span></li>
- <li>Module dis-engagemnt support- <span style="color: #FF0000">New</span></li>
- <li>Loading module (.mar) from classpath- <span style="color: #FF0000">New</span></li>
- <li>Sessions scoping for Application, SOAP, Transport and Request levels-<span style="color: #FF0000">New</span></li>
-</ol>
-
-<h4><a name="Experimental_Features_List">Experimental Features List</a></h4>
-<ol type="1">
- <li><a href="WS_policy.html" target="_blank">Server side & client side Web Service Policy support</a></li>
- <li>?wsdl and ?xsd support</li>
- <li>Generating ServiceClient for a given WSDL and invoke the corresponding service using generated client.</li>
-</ol>
-
-<h4><a name="Major_Changes_Since_Last_Release">Major Changes Since Last
-Release</a></h4>
-<ol type="1">
-   <li>Transport framework improvements (ListenerManager)</li>
-   <li>Changed the way of adding action to mapping (wsamapping) from parameter to child element so with this version onward the way of adding mapping is as follows:</li>
-   <pre>
-   
-&lt;actionMapping&gt;MyMapping&lt;/actionMapping&gt;
-
-</pre>
-<li>Refactored following packages in Axiom.
-    <ul>
-     <li>org.apache.axiom.om.impl.llom.builder to org.apache.axiom.om.impl.builder</li>
-     <li>org.apache.axiom.om.impl.llom.mtom to org.apache.axiom.om.impl.mtom</li>
-     <li>org.apache.axiom.om.impl.llom.serialize to org.apache.axiom.om.impl.serialize</li>
-     <li>org.apache.axiom.om.impl.llom.traverse to org.apache.axiom.om.impl.traverse</li>
-   </ul>
- </li>
-</ol>
-
-<h3><a name="Tools_included_in this_Release">Tools Included In This
-Release</a></h3>
-<ol type="1">
-  <li>Axis2 Web Application (Web App)</li>
-  <li>WSDL2WS- <!--<a href="CodegenTools-EclipsePlugin.html" target="_blank">Eclipse
-    plugin</a><a>/</a>--><a href="CodegenToolReference.html" target="_blank">Command line
-    version</a><!--<a>/</a><a
-    href="tools\idea\Idea_plug-in_userguide.html#WSDL2Java_Code_Generation" target="_blank">IntelliJ
-    IDEA plugin</a>--></li>
-  <!--<li>Service Archive Wizard- <a
-    href="ServiceArchiveToolReference.html" target="_blank">Eclipse plugin</a>/ <a
-    href="tools\idea\Idea_plug-in_userguide.html#Create_Service_Archive" target="_blank">IntelliJ
-    IDEA plugin</a>--></li>
-</ol>
-<p><a href="http://ws.apache.org/axis2/download.cgi" target="_blank">Download</a> above plugins</p>
-
-<h3><a name="What's_still_to_do_">What's Still To Do?</a></h3>
-
-<p>See list of what we think needs to be done, and consider helping out if
-you're interested &amp; able!</p>
-<ol type="1">
- <li>JAX-RPC 1.1 and/or JAX-WS compliance</li>
- <li>SOAP Encoding</li>
- <li>Binary serialization and de-serialization support</li>
- <li>Management Interface for Axis2</li>
- <li>Implementation of other Transports.</li>
- <li>Resource framework implementation (WS-RF) and Enterprise web services such as JSR 109 support</li>
- <li>Completion of Interop tests</li>
-</ol>
-
-<p align="right"><a href="userguide.html"><img
-src="images/arrow_left.gif"> Previous</a> | <a href="userguide2.html">Next <img src="images/arrow_right.gif"></a></p>
-
-Pages: <a href="userguide.html">Content</a>,
-<b>1</b>, <a href="userguide2.html">2</a>, <a href="userguide3.html"
->3</a>, <a href="userguide4.html">4</a>, <a
-href="userguide5.html">5</a></body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<html>
+<head>
+  <meta http-equiv="content-type" content="">
+  <title>Axis2 User's Guide</title>
+</head>
+
+<body lang="en-US" dir="ltr">
+<h4><a name="Axis2_User's_Guide">Axis2 User's Guide</a></h4>
+
+<p><i>Version 1.0</i></p>
+<p><i>User Feedback: <a
+href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a></i>. Prefix
+subject with [Axis2]. To subscribe to mailing list see <a
+href="http://ws.apache.org/axis2/mail-lists.html">here.</a></p>
+
+<p align="right">Pages: <a href="userguide.html">Content</a>, <b>1</b>, <a href="userguide2.html">2</a>, <a href="userguide3.html">3</a>, <a
+href="userguide4.html">4</a>, <a href="userguide5.html">5</a></p>
+
+<h2><a name="Introduction">Introduction</a></h2>
+
+<p>Welcome to Axis2, the next generation of Apache Axis!!! This User's Guide
+will help you to understand what Axis2 has to offer and how to get started
+with it. We hope you will benefit from the power of Axis2.</p>
+
+<h3><a name="Attention">Attention</a></h3>
+<ul>
+  <li><p style="margin-bottom: 0in">This User's Guide is written based on
+    Axis2 standard binary distribution. (The standard binary distribution can
+    be created from the source distribution using the maven goal <code>$maven
+    dist-std-bin</code>). Please refer the <a
+    href="installationguide.html#Download_Axis2">installation guide</a> for further
+    information on the downloadables available in this release.</p>
+  </li>
+  <li><p>If you are new to Axis, it's highly recommended that you read <a
+    href="http://ws.apache.org/axis/java/user-guide.html" target="_blank">Axis 1.x User's
+    Guide</a> before you go any further in this guide.</p>
+  </li>
+</ul>
+
+<h3><a name="What_is_Axis2_">What is Axis2?</a></h3>
+
+<p>Axis2 is the next generation of Apache Axis. In late August 2004, during
+the Axis2 Summit held in Colombo, Sri Lanka, a new architecture for Axis was
+introduced which was much more flexible, efficient and configurable. Although
+the architecture is new, some of the well established concepts from Axis 1.x
+like handlers are preserved in Axis2. Axis2 comes with many new features,
+enhancements and industry specification implementations.</p>
+
+<p>After months of continued discussion and coding in this direction, Axis2
+now delivers the following key features:</p>
+<ul>
+  <li><p style="margin-bottom: 0in"><strong>Speed</strong> - Axis2 uses its
+    own object model and StAX (Streaming API for XML) parsing to achieve
+    significantly greater speed than earlier versions of Apache Axis.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Low memory foot print</strong>-
+    Axis2 was designed ground-up keeping low memory foot print in mind.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>AXIOM</strong> - Axis2 comes with
+    its own light-weight object model, AXIOM, for message processing which is
+    extensible, high performance and developer convenient</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong><a name="Hot_Deployment">Hot
+    Deployment</a></strong> - Axis2 is equipped with the capability of
+    deploying web service &amp; handlers while system is up and running. In
+    other words, new services can be added to the system without having to
+    shut down server.Drop the required Web service archive into the services
+    directory in the repository and deployment model will automatically
+    deploy the service and make it available for use.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Asynchronous Web
+    Services</strong> - Axis2 now supports asynchronous web services &amp;
+    asynchronous web services invocation using non-blocking clients and
+    transports .</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2 now
+    comes handy with the flexibility to support Message Exchange Patterns
+    (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Flexibility</strong> - The Axis2
+    architecture gives the developer complete freedom to insert extensions
+    into the engine for custom header processing, system management, or
+    <em>anything else you can imagine</em>.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Stability</strong> - Axis2
+    defines a set of published interfaces which change relatively slowly
+    compared to the rest of Axis.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Component-oriented
+    Deployment</strong> - You can easily define reusable networks of Handlers
+    to implement common patterns of processing for your applications, or to
+    distribute to partners.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Transport Framework</strong> - We
+    have a clean and simple abstraction for integrating and using Transports
+    (i.e., senders and listeners for SOAP over various protocols such as
+    SMTP, FTP, message-oriented middleware, etc), and the core of the engine
+    is completely transport-independent.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
+    supports the <a href="http://www.w3.org/TR/wsdl" target="_blank">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 Axis2.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Add-ons</strong> Several web
+    services specifications have been incorporated including <a
+    href="http://ws.apache.org/wss4j/" target="_blank">WSS4J</a> for security, <a
+    href="http://ws.apache.org/sandesha/" target="_blank">Sandesha</a> for reliable
+    messaging, <a href="http://ws.apache.org/kandula/" target="_blank">Kandula</a> which is
+    an encapsulation of WS-Coordination, WS-AtomicTransaction and
+    WS-BusinessActivity.</p>
+  </li>
+  <li><p style="margin-bottom: 0in"><strong>Composition and
+    Extensibility</strong> - modules and phases improve support for
+    composability and extensibility. Modules supports composability and is
+    able to add support for new WS-* specifications in a simple and clean
+    manner. They are however not <a href="#Hot_Deployment">hot deployable</a>
+    as they change the overall behavior of the system.</p>
+  </li>
+</ul>
+
+<p>We hope you enjoy using Axis2. 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 us a hand! The Axis developer community welcomes your
+participation.</p>
+
+<p>Let us know what you think!</p>
+
+<p>Please send your feedback on Axis2 to "<a
+href="mailto:axis-user@ws.apache.org">axis-user@ws.apache.org</a>" and make
+sure to prefix the subject of the mail with [Axis2].</p>
+
+<h3><a name="Axis2_Complete_Features_List">Axis2 Complete Features
+List</a></h3>
+<ol type="1"> 
+ <li>AXIOM, an XML object model working on StAX (Streaming API for XML) parsing optimized for SOAP 1.1/1.2 Messages. This has complete XML infoset support.</li>
+ <li>Support for One-Way Messaging (In-Only) and Request Response Messaging (In-Out)</li>
+ <li>Module Architecture, mechanism to extend the SOAP Processing Model</li>
+ <li>Module version support , can have multiple versions of the same module and use them depending on the requirement.</li>
+ <li>Content hierarchy</li>
+ <li>Archive based deployment Model and Directory based deployment model</li>
+ <li>JWS like deployment (making Java class into Web service)</li>
+ <li>WSDL Code Generation Tool for Stub and skeletons</li>
+ <li>WS-Addressing, both the submission (2004/08) and final (2005/08) versions</li>
+ <li>WSS4J module for security</li>
+ <li>Improved and user friendly Client API</li>
+ <li>WSDL2Java and Java2WSDL</li>
+ <li>REST (REpresentational State Transfer) Support</li>
+ <li>Transports supports: HTTP, SMTP, TCP, JMS</li>
+ <li>Raw XML providers</li>
+ <li>Support for MTOM/ MIME/ SwA</li>
+ <li>SAAJ implementation</li>
+ <li>DOOM</li>
+ <li>Pack/Unpack capability for the generated code</li>
+ <li>Axis Data Binding - ADB (Framework and Schema Compiler)</li>
+ <li>Numerous bug fixes since last release</li>
+ <li>Transport framework improvements (ListenerManager)- <span style="color: #FF0000">New</span></li>
+ <li>AxisServlet auto start when application server get start up- <span style="color: #FF0000">New</span></li>
+ <li>Module dis-engagemnt support- <span style="color: #FF0000">New</span></li>
+ <li>Loading module (.mar) from classpath- <span style="color: #FF0000">New</span></li>
+ <li>Sessions scoping for Application, SOAP, Transport and Request levels-<span style="color: #FF0000">New</span></li>
+</ol>
+
+<h4><a name="Experimental_Features_List">Experimental Features List</a></h4>
+<ol type="1">
+ <li><a href="WS_policy.html" target="_blank">Server side & client side Web Service Policy support</a></li>
+ <li>?wsdl and ?xsd support</li>
+ <li>Generating ServiceClient for a given WSDL and invoke the corresponding service using generated client.</li>
+</ol>
+
+<h4><a name="Major_Changes_Since_Last_Release">Major Changes Since Last
+Release</a></h4>
+<ol type="1">
+   <li>Transport framework improvements (ListenerManager)</li>
+   <li>Changed the way of adding action to mapping (wsamapping) from parameter to child element so with this version onward the way of adding mapping is as follows:</li>
+   <pre>
+   
+&lt;actionMapping&gt;MyMapping&lt;/actionMapping&gt;
+
+</pre>
+<li>Refactored following packages in Axiom.
+    <ul>
+     <li>org.apache.axiom.om.impl.llom.builder to org.apache.axiom.om.impl.builder</li>
+     <li>org.apache.axiom.om.impl.llom.mtom to org.apache.axiom.om.impl.mtom</li>
+     <li>org.apache.axiom.om.impl.llom.serialize to org.apache.axiom.om.impl.serialize</li>
+     <li>org.apache.axiom.om.impl.llom.traverse to org.apache.axiom.om.impl.traverse</li>
+   </ul>
+ </li>
+</ol>
+
+<h3><a name="Tools_included_in this_Release">Tools Included In This
+Release</a></h3>
+<ol type="1">
+  <li>Axis2 Web Application (Web App)</li>
+  <li>WSDL2WS- <!--<a href="CodegenTools-EclipsePlugin.html" target="_blank">Eclipse
+    plugin</a><a>/</a>--><a href="CodegenToolReference.html" target="_blank">Command line
+    version</a><!--<a>/</a><a
+    href="tools\idea\Idea_plug-in_userguide.html#WSDL2Java_Code_Generation" target="_blank">IntelliJ
+    IDEA plugin</a>--></li>
+  <!--<li>Service Archive Wizard- <a
+    href="ServiceArchiveToolReference.html" target="_blank">Eclipse plugin</a>/ <a
+    href="tools\idea\Idea_plug-in_userguide.html#Create_Service_Archive" target="_blank">IntelliJ
+    IDEA plugin</a>--></li>
+</ol>
+<p><a href="http://ws.apache.org/axis2/download.cgi" target="_blank">Download</a> above plugins</p>
+
+<h3><a name="What's_still_to_do_">What's Still To Do?</a></h3>
+
+<p>See list of what we think needs to be done, and consider helping out if
+you're interested &amp; able!</p>
+<ol type="1">
+ <li>JAX-RPC 1.1 and/or JAX-WS compliance</li>
+ <li>SOAP Encoding</li>
+ <li>Binary serialization and de-serialization support</li>
+ <li>Management Interface for Axis2</li>
+ <li>Implementation of other Transports.</li>
+ <li>Resource framework implementation (WS-RF) and Enterprise web services such as JSR 109 support</li>
+ <li>Completion of Interop tests</li>
+</ol>
+
+<p align="right"><a href="userguide.html"><img
+src="images/arrow_left.gif"> Previous</a> | <a href="userguide2.html">Next <img src="images/arrow_right.gif"></a></p>
+
+Pages: <a href="userguide.html">Content</a>,
+<b>1</b>, <a href="userguide2.html">2</a>, <a href="userguide3.html"
+>3</a>, <a href="userguide4.html">4</a>, <a
+href="userguide5.html">5</a></body>
+</html>



Mime
View raw message