You are viewing a plain text version of this content. The canonical link for it is here.
Posted to axis-cvs@ws.apache.org by ch...@apache.org on 2006/04/20 07:32:07 UTC
svn commit: r395490 [1/3] - in /webservices/axis2/trunk/java/xdocs: ./
latest/
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 & 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
+ & 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 & 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:// <host :port>/ 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 <webapps>/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 & 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:// <host :port>/ 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 <webapps>/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_"axis2_xml"">Step
- 4: Modify the "axis2.xml"</a></li>
- <li><a
- href="userguide4.html#Step5_:_Modify_the_"services_xml"">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 & 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_"axis2_xml"">Step
+ 4: Modify the "axis2.xml"</a></li>
+ <li><a
+ href="userguide4.html#Step5_:_Modify_the_"services_xml"">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 & 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 &
- 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>
-
-<actionMapping>MyMapping</actionMapping>
-
-</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 & 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 & 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 &
+ 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>
+
+<actionMapping>MyMapping</actionMapping>
+
+</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 & 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>