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/01/19 17:25:06 UTC
svn commit: r370524 [7/11] - in /webservices/axis2/site: ./ 0_93/ 0_93/adb/
0_93/tools/idea-guide/ 0_94/ 0_94/adb/ 0_94/images/ 0_94/tools/idea/
modules/ modules/addressing/ modules/wss4j/ modules/wss4j/0_94/0.94/
multiproject/axis2-Samples/ multiproje...
Modified: webservices/axis2/site/0_94/userguide1.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/0_94/userguide1.html?rev=370524&r1=370523&r2=370524&view=diff
==============================================================================
--- webservices/axis2/site/0_94/userguide1.html (original)
+++ webservices/axis2/site/0_94/userguide1.html Thu Jan 19 08:22:01 2006
@@ -2,10 +2,10 @@
@import url("../style/maven-base.css");
@import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 18 January 2006
- | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <b>1</b>, <a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>, <a href="userguide3.html" class="newWindow" title="New Window" target="_blank">3</a>, <a href="userguide4.html" class="newWindow" title="New Window" target="_blank">4</a>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p></div><div class="section"><a name="Introduction"></a><h2>Introduction</h2><p>Welcome to Axis2, the next generation of Apache Axis!!! This User's Guide
+ Last published: 19 January 2006
+ | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="Axis2_User_s_Guide"></a></p></div><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <b>1</b>, <a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>, <a href="userguide3.html" class="newWindow" title="New Window" target="_blank">3</a>, <a href="userguide4.html" class="newWindow" title="New Window" target="_blank">4</a>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p><p><a name="Introduction"></a></p></div><div class="section"><a name="Introduction"></a><h2>Introduction</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><div class="subsection"><a name="Attention"></a><h3>Attention</h3><ul>
+with it. We hope you will benefit from the power of Axis2.</p><p><a name="Attention"></a></p><div class="subsection"><a name="Attention"></a><h3>Attention</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
@@ -15,85 +15,86 @@
<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" class="newWindow" title="New Window" target="_blank">Axis 1.x User's
Guide</a> before you go any further in this guide.</p>
</li>
-</ul></div><div class="subsection"><a name="What_is_Axis2_"></a><h3>What is Axis2?</h3><p>Axis2 is the next generation of Apache Axis. In late August 2004, during
+</ul><p><a name="What_is_Axis2_"></a></p></div><div class="subsection"><a name="What_is_Axis2_"></a><h3>What is Axis2?</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
+ <li><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>
+ significantly greater speed than earlier versions of Apache Axis.
</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><strong>Low memory foot print</strong>-
+ Axis2 was designed ground-up keeping low memory foot print in mind.
</li>
- <li><p style="margin-bottom: 0in"><strong>AXIOM</strong> - Axis2 comes with
+ <li><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>
+ extensible, high performance and developer convenient
</li>
- <li><p style="margin-bottom: 0in"><strong><a name="Hot_Deployment">Hot
- Deployment</a></strong> - Axis2 is equipped with the capability of
+ <a name="Hot_Deployment"></a>
+ <li><strong>Hot
+ Deployment</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>
+ deploy the service and make it available for use.
</li>
- <li><p style="margin-bottom: 0in"><strong>Asynchronous Web
+ <li><strong>Asynchronous Web
Services</strong> - Axis2 now supports asynchronous web services &
asynchronous web services invocation using non-blocking clients and
- transports .</p>
+ transports .
</li>
- <li><p style="margin-bottom: 0in"><strong>MEP Support</strong> - Axis2 now
+ <li><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>
+ (MEPs) with in-built support for basic MEPs defined in WSDL 2.0.
</li>
- <li><p style="margin-bottom: 0in"><strong>Flexibility</strong> - The Axis2
+ <li><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>
+ <em>anything else you can imagine</em>.
</li>
- <li><p style="margin-bottom: 0in"><strong>Stability</strong> - Axis2
+ <li><strong>Stability</strong> - Axis2
defines a set of published interfaces which change relatively slowly
- compared to the rest of Axis.</p>
+ compared to the rest of Axis.
</li>
- <li><p style="margin-bottom: 0in"><strong>Component-oriented
+ <li><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>
+ distribute to partners.
</li>
- <li><p style="margin-bottom: 0in"><strong>Transport Framework</strong> - We
+ <li><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>
+ is completely transport-independent.
</li>
- <li><p style="margin-bottom: 0in"><strong>WSDL support</strong> - Axis2
+ <li><strong>WSDL support</strong> - Axis2
supports the <a href="http://www.w3.org/TR/wsdl" class="newWindow" title="New Window" 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>
+ machine-readable descriptions of your deployed services from Axis2.
</li>
- <li><p style="margin-bottom: 0in"><strong>Add-ons</strong> Several web
+ <li><strong>Add-ons</strong> Several web
services specifications have been incorporated including <a href="http://ws.apache.org/wss4j/" class="newWindow" title="New Window" target="_blank">WSS4J</a> for security, <a href="http://ws.apache.org/sandesha/" class="newWindow" title="New Window" target="_blank">Sandesha</a> for reliable
messaging, <a href="http://ws.apache.org/kandula/" class="newWindow" title="New Window" target="_blank">Kandula</a> which is
an encapsulation of WS-Coordination, WS-AtomicTransaction and
- WS-BusinessActivity.</p>
+ WS-BusinessActivity.
</li>
- <li><p style="margin-bottom: 0in"><strong>Composition and
+ <li><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>
+ as they change the overall behavior of the system.
</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></div><div class="subsection"><a name="Axis2_Complete_Features_List"></a><h3>Axis2 Complete Features List</h3><ol type="1">
+sure to prefix the subject of the mail with [Axis2].</p><p><a name="Axis2_Complete_Features_List"></a></p></div><div class="subsection"><a name="Axis2_Complete_Features_List"></a><h3>Axis2 Complete Features List</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>
@@ -120,7 +121,7 @@
<li>Pack/Unpack capability for the generated code- New Feature</li>
<li>Axis Data Binding - ADB (Framework and Schema Compiler)</li>
<li>Numerous bug fixes since last release</li>
-</ol></div><div class="subsection"><a name="Experimental_Features_List"></a><h3>Experimental Features List</h3><ol type="1">
+</ol><p><a name="Experimental_Features_List"></a></p></div><div class="subsection"><a name="Experimental_Features_List"></a><h3>Experimental Features List</h3><ol type="1">
<li>Sessions scoping for Application, SOAP, Transport and Request
levels</li>
<li><a href="WS_policy.html" class="newWindow" title="New Window" target="_blank">Server side Web Service Policy
@@ -129,7 +130,7 @@
<li>Java2WSDL</li>
<li>Generating ServiceClient for a given WSDL and invoke the corresponding
service using generated client.</li>
-</ol></div><div class="subsection"><a name="Major_Changes_Since_Last_Release"></a><h3>Major Changes Since Last Release</h3><ol type="1">
+</ol><p><a name="Major_Changes_Since_Last_Release"></a></p></div><div class="subsection"><a name="Major_Changes_Since_Last_Release"></a><h3>Major Changes Since Last Release</h3><ol type="1">
<li>Fixing of memory leaks</li>
<li>Client API changes , Introducing ServiceClient instead of MEPClient,
InOnlyMEPClient, InOutMEPClient, Call. (Please note that the above
@@ -138,7 +139,7 @@
module and use them depending on the requirement.</li>
<li>Code generator improved to process multi-port WSDL's properly</li>
<li>Packing and unpacking options for the code generated classes</li>
-</ol></div><div class="subsection"><a name="Tools_Included_In_This_Release"></a><h3>Tools Included In This Release</h3><ol type="1">
+</ol><p><a name="Tools_included_in_this_Release"></a></p></div><div class="subsection"><a name="Tools_Included_In_This_Release"></a><h3>Tools Included In This Release</h3><ol type="1">
<li>Axis2 Web Application (Web App)</li>
<li>WSDL2WS- <a href="CodegenTools-EclipsePlugin.html" class="newWindow" title="New Window" target="_blank">Eclipse
plugin</a><a>/</a><a href="CodegenToolReference.html" class="newWindow" title="New Window" target="_blank">Command line
@@ -147,8 +148,7 @@
<li>Service Archive Wizard- <a href="ServiceArchiveToolReference.html" class="newWindow" title="New Window" target="_blank">Eclipse plugin</a>/ <a href="tools\idea\Idea_plug-in_userguide.html#Create_Service_Archive" class="newWindow" title="New Window" target="_blank">IntelliJ
IDEA plugin</a></li>
</ol><p><a href="http://ws.apache.org/axis2/download.cgi" class="newWindow" title="New Window" target="_blank">Download</a> above plugins
-
-</p></div><div class="subsection"><a name="What_s_Still_To_Do_"></a><h3>What's Still To Do?</h3><p>See list of what we think needs to be done, and consider helping out if
+<a name="What_s_still_to_do_"></a></p></div><div class="subsection"><a name="What_s_Still_To_Do_"></a><h3>What's Still To Do?</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>
Modified: webservices/axis2/site/0_94/userguide2.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/0_94/userguide2.html?rev=370524&r1=370523&r2=370524&view=diff
==============================================================================
--- webservices/axis2/site/0_94/userguide2.html (original)
+++ webservices/axis2/site/0_94/userguide2.html Thu Jan 19 08:22:01 2006
@@ -2,23 +2,22 @@
@import url("../style/maven-base.css");
@import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 18 January 2006
- | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
+ Last published: 19 January 2006
+ | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="Axis2_User_s_Guide"></a></p></div><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
<b>2</b>, <a href="userguide3.html" class="newWindow" title="New Window" target="_blank">3</a>, <a href="userguide4.html" class="newWindow" title="New Window" target="_blank">4</a>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p><b><font size="4">Note (on samples):</font></b><p> In this page of the user's
guide we will look at how to write and deploy Web Services using Axis2. All
the user's guide samples are located in the <b>"samples/userguide/src"</b>
directory of the binary distribution.
-
-</p></div><div class="section"><a name="Web_Services_Using_Axis2"></a><h2>Web Services Using Axis2</h2><p>Before starting, please check whether you have deployed the "axis2.war" in
+<a name="Web_Services_Using_Axis2"></a></p></div><div class="section"><a name="Web_Services_Using_Axis2"></a><h2>Web Services Using Axis2</h2><p>Before starting, please check whether you have deployed the "axis2.war" in
your servlet container and it is working properly. (See <a href="installationguide.html" class="newWindow" title="New Window" target="_blank">Installation Guide</a>). User
-can select any of the following two ways of writing web services using
+can select any of the following two ways of writing web services using
Axis2. </p><ol>
<li><a href="#Writing_Web_Services_Using_Axis2_s_Primary_APIs">Use Axis2's primary interfaces (APIs) and implement
the business logic.</a></li>
<li><p><a href="#Writing_Web_Services_by_Code_Generating_Skeleton">Start from the WSDL ->Code generate the
Skeleton ->Implement the Business Logic.</a></p>
</li>
-</ol><div class="subsection"><a name="Writing_Web_Services_Using_Axis2_s_Primary_APIs"></a><h3>Writing Web Services Using Axis2's Primary APIs</h3></div><div class="subsection"><a name="Creating_Web_Service__MyService_"></a><h3>Creating Web Service (MyService)</h3><p>First let's see how we can write a simple Web Service (MyService) using
+</ol><p><a name="Writing_Web_Services_Using_Axis2_s_Primary_APIs"></a></p><div class="subsection"><a name="Writing_Web_Services_Using_Axis2_s_Primary_APIs"></a><h3>Writing Web Services Using Axis2's Primary APIs</h3><p><a name="Creating_Web_Service__MyService_"></a></p></div><div class="subsection"><a name="Creating_Web_Service__MyService_"></a><h3>Creating Web Service (MyService)</h3><p>First let's see how we can write a simple Web Service (MyService) using
Axis2's primary interfaces and deploy it. For this purpose we will create a
Web Service with two operations as follows.</p>
<div class="source"><pre>public void ping(OMElement element){} //IN-ONLY operation, just accepts the OMElement and do some processing.
@@ -30,20 +29,20 @@
"Axis2Home/samples/userguide/src" directory under "userguide/example1"
package. As you can see, the two operations are very simple and need no
explanations on what they do. Now let's see how we can write the deployment
-descriptors for the service and deploy it.</p></div><div class="subsection"><a name="How_to_write_the_Web_Service_"></a><h3>How to write the Web Service?</h3><p>
+descriptors for the service and deploy it.</p><p><a name="How_to_write_the_Web_Service_"></a></p></div><div class="subsection"><a name="How_to_write_the_Web_Service_"></a><h3>How to write the Web Service?</h3><p>
Writing a new Web Service with Axis2 involve four steps:
<ol>
- <li><p style="margin-bottom: 0in">Write the Implementation Class</p>
+ <li>Write the Implementation Class
</li>
- <li><p style="margin-bottom: 0in">Write a services.xml file to explain the
- Web Service</p>
+ <li>Write a services.xml file to explain the
+ Web Service
</li>
- <li><p style="margin-bottom: 0in">create a *.aar archive (Axis Archive) for
- the Web Service</p>
+ <li>create a *.aar archive (Axis Archive) for
+ the Web Service
</li>
- <li><p>Deploy the Web Service</p>
+ <li>Deploy the Web Service
</li>
-</ol></p></div><div class="subsection"><a name="Step1_:Write_the_Implementation_Class"></a><h3>Step1 :Write the Implementation Class</h3><p>Provides a implementation class that provide the business logic for the
+</ol><a name="Step1_:Write_the_Implementation_Class"></a></p></div><div class="subsection"><a name="Step1_:Write_the_Implementation_Class"></a><h3>Step1 :Write the Implementation Class</h3><p>Provides a implementation class that provide the business logic for the
Web Service, it should have methods that match the operations in the Web
Service. Unless you have data binding the signature of the methods can have
one parameter of type OMElement.</p>
@@ -56,8 +55,8 @@
}
}
-</pre></div>
- </div><div class="subsection"><a name="Step2_:Write_the_services_xml_file"></a><h3>Step2 :Write the services.xml file</h3><p>Axis2 uses "services.xml" to keep configurations for a Web Service. Each
+ </pre></div>
+ <p><a name="Step2_:Write_the_services_xml_file"></a></p></div><div class="subsection"><a name="Step2_:Write_the_services_xml_file"></a><h3>Step2 :Write the services.xml file</h3><p>Axis2 uses "services.xml" to keep configurations for a Web Service. Each
Web Service deployed in Axis2 needs a "services.xml" containing the
configurations. "services.xml" for MyService will be as follows.</p>
<div class="source"><pre><service >
@@ -97,12 +96,12 @@
</serviceGroup>
</pre></div>
- <p>Note : name of the service is a compulsory attribute</p></div><div class="subsection"><a name="Step3_:Create_the_Web_Service_Archive"></a><h3>Step3 :Create the Web Service Archive</h3><p>Axis2 use ".aar" (Axis Archive) file as the deployment package for Web
+ <p>Note : name of the service is a compulsory attribute</p><p><a name="Step3_:Create_the_Web_Service_Archive"></a></p></div><div class="subsection"><a name="Step3_:Create_the_Web_Service_Archive"></a><h3>Step3 :Create the Web Service Archive</h3><p>Axis2 use ".aar" (Axis Archive) file as the deployment package for Web
Services. Therefore, for MyService we will use "MyService.aar" with the
-"services.xml" packaged in the META-INF as shown in the following picture.</p><p><img src="images/userguide/ServiceItems.jpg" name="Graphic1" align="bottom" width="176" height="91" border="0" alt=""></img></p><p>To create "MyService.aar" user can first create a jar file containing all
+"services.xml" packaged in the META-INF as shown in the following picture.</p><p><img src="images/userguide/ServiceItems.jpg" name="Graphic1" alt="" align="bottom" width="176" height="91" border="0"></img></p><p>To create "MyService.aar" user can first create a jar file containing all
the files necessary for the service and then rename the "jar" to "aar" so
that Axis2 understands it as a service archive. This has already been created
-in the "Axis2Home/samples/userguide" directory. Now let's use it...</p></div><div class="subsection"><a name="Step4_:Deploy_the_Web_Service"></a><h3>Step4 :Deploy the Web Service</h3><p>Deploying the service is just a matter of dropping the ".aar" in to
+in the "Axis2Home/samples/userguide" directory. Now let's use it...</p><p><a name="Step4_:Deploy_the_Web_Service"></a></p></div><div class="subsection"><a name="Step4_:Deploy_the_Web_Service"></a><h3>Step4 :Deploy the Web Service</h3><p>Deploying the service is just a matter of dropping the ".aar" in to
"services" directory that can be found in the "\webapps\axis2\WEB-INF" of
your servlet container, hence copy the "MyService.aar" into the
"<b>services</b>" directory. Once these steps are completed, start the
@@ -110,12 +109,12 @@
"Services" on the <a href="http://localhost:8080/axis2/index.jsp" class="newWindow" title="New Window" target="_blank">Home Page of Axis2 Web Application</a>
(http://localhost:8080/axis2/index.jsp) and see whether the MyService is
deployed properly. If you can see the following output then you have
-successfully deployed MyService on Axis2.</p><p align="center"><img src="images/userguide/MyServiceDeployed.jpg" name="Graphic2" align="bottom" width="734" height="766" border="0" alt=""></img></p><p>Note: Axis2 provides an easy way to deploy Web Services using the "Upload
+successfully deployed MyService on Axis2.</p><p align="center"><img src="images/userguide/MyServiceDeployed.jpg" alt="" name="Graphic2" align="bottom" width="734" height="766" border="0"></img></p><p>Note: Axis2 provides an easy way to deploy Web Services using the "Upload
Service" tool on Axis2 Web Application's Administration module. (See the <a href="webadminguide.html" class="newWindow" title="New Window" target="_blank">Web Administration Guide</a> for
-more information on this)</p></div><div class="subsection"><a name="Writing_Web_Services_by_Code_Generating_Skeleton"></a><h3>Writing Web Services by Code Generating Skeleton</h3><p>This is the second method of writing Web Services using Axis2. Let's see
+more information on this)</p><p><a name="Writing_Web_Services_by_Code_Generating_Skeleton"></a></p></div><div class="subsection"><a name="Writing_Web_Services_by_Code_Generating_Skeleton"></a><h3>Writing Web Services by Code Generating Skeleton</h3><p>This is the second method of writing Web Services using Axis2. Let's see
how we can generate the skeleton from a given WSDL and implement the business
logic using Axis2. For this we use Axis2SampleDocLit.wsdl that can be found
-in the <b>wsdl</b> directory under samples.</p></div><div class="subsection"><a name="WSDL2Java_Tool"></a><h3>WSDL2Java Tool</h3><p>To generate the skeleton and the required classes you can use the
+in the <b>wsdl</b> directory under samples.</p><p><a name="WSDL2Java_Tool"></a></p></div><div class="subsection"><a name="WSDL2Java_Tool"></a><h3>WSDL2Java Tool</h3><p>To generate the skeleton and the required classes you can use the
WSDL2Java tool provided in Axis2. This tool is located in the bin directory
of the distribution and can be executed using the provided scripts (.bat or
.sh). The tool's parameter list is as follows and user can specify these
@@ -143,24 +142,22 @@
<p>This will generate the required classes in the <b>src</b> directory inside
samples, and the schema classes in <strong>schema</strong> directory also
inside samples. Note that these are not source files and should be availed in
-the class path in order to compile the generated classes</p></div><div class="subsection"><a name="Implement_the_Business_Logic"></a><h3>Implement the Business Logic</h3><p>Locate the skeleton class that can be found under src/userguide directory
+the class path in order to compile the generated classes</p><p><a name="Implement_the_Business_Logic"></a></p></div><div class="subsection"><a name="Implement_the_Business_Logic"></a><h3>Implement the Business Logic</h3><p>Locate the skeleton class that can be found under src/userguide directory
with the name "Axis2SampleDocLitPortTypeSkeleton.java". This is the skeleton
for our web service and we can now easily implement the business logic. The
WSDL we have used has three operations:
</p><ul>
- <li><p style="margin-bottom: 0in">echoString - Operation that echoes a
- String value </p>
+ <li>echoString - Operation that echoes a
+ String value
</li>
- <li><p style="margin-bottom: 0in">echoStringArray - Operation that accept
- string array as the input and echoes them back</p>
+ <li>echoStringArray - Operation that accept
+ string array as the input and echoes them back
</li>
- <li><p>echoStruct - Operation that accept a Struct as the input and echoes
- them back.</p>
+ <li>echoStruct - Operation that accept a Struct as the input and echoes
+ them back.
</li>
-</ul><p>
-
-</p></div><div class="subsection"><a name="echoString"></a><h3>echoString</h3><p>Locate the following code segment in the
-"Axis2SampleDocLitPortTypeSkeleton.java" and fill the business logic as
+</ul><p><a name="echoString"></a></p></div><div class="subsection"><a name="echoString"></a><h3>echoString</h3><p>Locate the following code segment in the
+"Axis2SampleDocLitPortTypeSkeleton.java" and fill the business logic as
shown below.</p>
<div class="source"><pre> public org.soapinterop.xsd.EchoStringArrayReturnDocument
echoStringArray(org.soapinterop.xsd.EchoStringArrayParamDocument param2){
@@ -182,7 +179,7 @@
</pre></div>
<p>Similarly following code fragments shows how you can fill the business
-logic for our first web service.</p></div><div class="subsection"><a name="echoStringArray"></a><h3>echoStringArray</h3>
+logic for our first web service.</p><p><a name="echoStringArray"></a></p></div><div class="subsection"><a name="echoStringArray"></a><h3>echoStringArray</h3>
<div class="source"><pre>public org.soapinterop.xsd.EchoStringArrayReturnDocument
echoStringArray(org.soapinterop.xsd.EchoStringArrayParamDocument param2) {
@@ -202,8 +199,8 @@
return retDoc;
}
-</pre></div>
- </div><div class="subsection"><a name="echoStruct"></a><h3>echoStruct</h3>
+ </pre></div>
+ <p><a name="echoStruct"></a></p></div><div class="subsection"><a name="echoStruct"></a><h3>echoStruct</h3>
<div class="source"><pre>public org.soapinterop.xsd.EchoStructReturnDocument
echoStruct(org.soapinterop.xsd.EchoStructParamDocument param4) {
@@ -225,9 +222,8 @@
return retDoc;
}
-
-</pre></div>
- </div><div class="subsection"><a name="services_xml"></a><h3>services.xml</h3><p> Axis2 uses "services.xml" to hold the configurations for a particular web
+ </pre></div>
+ <p><a name="services_xml"></a></p></div><div class="subsection"><a name="services_xml"></a><h3>services.xml</h3><p>Axis2 uses "services.xml" to hold the configurations for a particular web
service deployed in the Axis2 engine. When we generate the skeleton using the
WSDL2Java tool, it will also generate the required services.xml for this web
service as well. This can be found in the same directory as the skeleton. The
@@ -253,20 +249,20 @@
<p>First line of the "services.xml" gives the name of the Web Service. This
is used in the URL to the service as the service name. Next comes the
description and the service class. The next xml tags describe the operations
-that are available in this service with respective message receivers.</p></div><div class="subsection"><a name="Packaging"></a><h3>Packaging</h3><p>Next step in the process is to package the classes in a .aar (axis2
+that are available in this service with respective message receivers.</p><p><a name="Packaging"></a></p></div><div class="subsection"><a name="Packaging"></a><h3>Packaging</h3><p>Next step in the process is to package the classes in a .aar (axis2
archive) and deploy it in Axis2. When the WSDL2Java tool generate the
skeleton it will also generate the required data binding classes. These
schema related classes are located in the <b>schema </b>directory of the
generated code. Copy this to your class path, compile the skeleton and the
supporting classes. In order to create the .aar file, let's create the
following directory structure with the required files and then simply use jar
-command to package it.</p><p><img src="images/userguide/DirectoryStructure.JPG" align="bottom" width="164" height="142" border="0" alt=""></img></p><p>Go to the top level directory where you can find the class files for the
+command to package it.</p><p><img src="images/userguide/DirectoryStructure.JPG" align="bottom" alt="" width="164" height="142" border="0"></img></p><p>Go to the top level directory where you can find the class files for the
above service (i.e. one level up on the directory structure shown above),
then type the following command in a command line.</p>
<div class="source"><pre>jar -cf Axis2SampleDocLitPortType.aar .
</pre></div>
- <p>Deploying the service is just a matter of dropping the ".aar" in to
+ <p>Deploying the service is just a matter of dropping the ".aar" in to
"services" directory that can be found in the "\webapps\axis2\WEB-INF" of
your servlet container, hence copy the "echo.aar" into the "<b>services</b>"
directory. Once these steps are completed, please start the servlet container
@@ -274,6 +270,6 @@
Axis2 Web Application</a> (http://localhost:8080/axis2/index.jsp) and see
whether the Axis2SampleDocLitPortType is deployed properly. If you can see
the following output then you have successfully deployed
-Axis2SampleDocLitPortType on Axis2.</p><p align="center"><img src="images/userguide/ServiceDeployed.JPG" name="Graphic4" align="bottom" width="734" height="764" border="0" alt=""></img></p><p>Note: Axis2 provides an easy way to deploy Web Services using the "Upload
+Axis2SampleDocLitPortType on Axis2.</p><p align="center"><img src="images/userguide/ServiceDeployed.JPG" alt="" name="Graphic4" align="bottom" width="734" height="764" border="0"></img></p><p>Note: Axis2 provides an easy way to deploy Web Services using the "Upload
Service" tool on Axis2 Web Application's Administration module. (See the <a href="webadminguide.html" class="newWindow" title="New Window" target="_blank">Web Administration Guide</a> for
more information on this)</p><p align="right"><a href="userguide1.html" class="newWindow" title="New Window" target="_blank"><img src="images/arrow_left.gif" alt=""></img> Previous</a> | <a href="userguide3.html" class="newWindow" title="New Window" target="_blank">Next <img src="images/arrow_right.gif" alt=""></img></a></p><p>Pages: <a href="userguide.html" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>, <b>2</b>, <a href="userguide3.html" class="newWindow" title="New Window" target="_blank">3</a>, <a href="userguide4.html" class="newWindow" title="New Window" target="_blank">4</a>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2006, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
Modified: webservices/axis2/site/0_94/userguide3.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/0_94/userguide3.html?rev=370524&r1=370523&r2=370524&view=diff
==============================================================================
--- webservices/axis2/site/0_94/userguide3.html (original)
+++ webservices/axis2/site/0_94/userguide3.html Thu Jan 19 08:22:01 2006
@@ -2,41 +2,41 @@
@import url("../style/maven-base.css");
@import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 18 January 2006
- | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
+ Last published: 19 January 2006
+ | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="Axis2_User_s_Guide"></a></p></div><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
<a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>, <b>3</b>, <a href="userguide4.html" class="newWindow" title="New Window" target="_blank">4</a>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p><p><b><font size="4">Note (on samples):</font></b> In this page of the user's
guide we will look at how to write Web Service Clients using Axis2. All the
user's guide samples are located at the <b><font color="#000000">"samples/userguide/src"</font></b> directory of the binary
-distribution. So... let's explore the samples.</p></div><div class="section"><a name="Web_Service_Clients_Using_Axis2"></a><h2>Web Service Clients Using Axis2</h2><p>Now let's see how we can write a Web Service Client to use this Web
+distribution. So... let's explore the samples.</p><p><a name="Web_Service_Clients_Using_Axis2"></a></p></div><div class="section"><a name="Web_Service_Clients_Using_Axis2"></a><h2>Web Service Clients Using Axis2</h2><p>Now let's see how we can write a Web Service Client to use this Web
Service.</p><p>Web services can be used to provide wide range of functionality to the
-users ranging from simple, less time consuming operations such as
-"getStockQuote" to time consuming business services. When we utilize (invoke
+users ranging from simple, less time consuming operations such as
+"getStockQuote" to time consuming business services. When we utilize (invoke
using client applications) these Web Service we cannot use some simple
generic invocation paradigm that suites all the timing complexities involved
in the service operations. For example, if we use a single transport channel
(such as HTTP) to invoke a Web Service with and IN-OUT operation that take
long time to complete, then most of the time we may end up with "connection
time outs". On the other hand, if there are simultaneous service invocations
-that we need to perform from a single client application, then the use of a
+that we need to perform from a single client application, then the use of a
"blocking" client API will degrade the performance of the client application.
Similarly there are various other consequences such as One-Way transports
that come in to play when we need them. Let's try to analyze some common
service invocation paradigms.</p><p>Many web service engines provide the users with a Blocking and
Non-Blocking client APIs.</p><ul>
- <li><p style="margin-bottom: 0in"><b>Blocking API</b> -Once the service
+ <li><b>Blocking API</b> -Once the service
invocation is called, the client application hangs and only gets control
back when the operation completes, after which client receives a response
or a fault. This is the simplest way of invoking Web Services and it also
- suites many business situations.</p>
+ suites many business situations.
</li>
- <li><p><b>Non-Blocking API </b>- This is a callback or polling based API,
+ <li><b>Non-Blocking API </b>- This is a callback or polling based API,
hence once a service invocation is called, the client application
immediately gets the control back and the response is retrieved using the
callback object provided. This approach provides the flexibility to the
client application to invoke several Web Services simultaneously without
- blocking the operation already invoked.</p>
+ blocking the operation already invoked.
</li>
-</ul><p>Both these mechanisms work in the API level. Let's name the asynchronous
+</ul><p>Both these mechanisms work in the API level. Let's name the asynchronous
behavior that we can get using the <strong>Non-Blocking API</strong> as
<b>API Level Asynchrony.</b></p><p>Both these mechanisms use single transport connection to send the request
and to receive the response. They severely lags the capability of using two
@@ -51,7 +51,7 @@
following table.</p><p><a name="table1"></a><table class="bodyTable"><tbody>
<tr class="b"><td width="33%" height="19"><p><strong>API
(Blocking/Non-Blocking)</strong></p>
- </td><td width="33%"><p><strong> Dual Transports (Yes/No)</strong></p>
+ </td><td width="33%"><p><strong>Dual Transports (Yes/No)</strong></p>
</td><td width="33%"><p><strong>Description</strong></p>
</td></tr>
<tr class="a"><td width="33%" height="19"><p>Blocking</p>
@@ -81,7 +81,7 @@
support</a>, making the life easy for developers writing Web Service
client applications</p>
</li>
-</ol><div class="subsection"><a name="Writing_Web_Service_Clients_Using_Axis2_s_Primary_APIs"></a><h3>Writing Web Service Clients Using Axis2's Primary APIs</h3></div><div class="subsection"><a name="EchoBlockingClient"></a><h3>EchoBlockingClient</h3><p>Axis2 provides the user with several invocation patterns for Web Services,
+</ol><p><a name="Writing_Web_Service_Clients_using_Axis2_s_Primary_APIs"></a></p><div class="subsection"><a name="Writing_Web_Service_Clients_Using_Axis2_s_Primary_APIs"></a><h3>Writing Web Service Clients Using Axis2's Primary APIs</h3><p><a name="EchoBlockingClient"></a></p></div><div class="subsection"><a name="EchoBlockingClient"></a><h3>EchoBlockingClient</h3><p>Axis2 provides the user with several invocation patterns for Web Services,
ranging from pure blocking single channel invocations to a non-blocking dual
channel invocations. Let's first see how we can write a client to invoke
"echo" operation of "MyService" using the simplest blocking invocation. The
@@ -111,9 +111,9 @@
that needs to be sent and display the response OMElement. To test this
client, use the provided ant build file that can be found in the
"Axis2Home/samples" directory. Run the "testEchoBlockingClient" target . If
-you can see the response OMElement printed in your command line, then you
-have successfully tested the client. </p></div><div class="subsection"><a name="PingClient"></a><h3>PingClient</h3><p>In the Web Service "MyService" we had a IN-ONLY operation with the name
-"ping" (see <a href="userguide2.html#Web_Services_Using_Axis2" tareget="_blank">Web Services Using
+you can see the response OMElement printed in your command line, then you
+have successfully tested the client. </p><p><a name="PingClient"></a></p></div><div class="subsection"><a name="PingClient"></a><h3>PingClient</h3><p>In the Web Service "MyService" we had a IN-ONLY operation with the name
+"ping" (see <a href="userguide2.html#Web_Services_Using_Axis2" class="newWindow" title="New Window" target="_blank">Web Services Using
Axis2</a>). Let's write a client to invoke this operation. The client code is
as follows:</p>
<div class="source"><pre> try {
@@ -136,7 +136,7 @@
to the client. You can test this client by running the target
"testPingClient" of the ant build file at "Axis2Home/samples".</p><p>We have invoked the two operations in our service. Are we done? No! There
are lot more to explore. Let's see some other ways to invoke the same
-operations...</p></div><div class="subsection"><a name="EchoNonBlockingClient"></a><h3>EchoNonBlockingClient</h3><p>In the EchoBlockingClient once the "serviceCleint.sendReceive(payload);"
+operations...</p><p><a name="EchoNonBlockingClient"></a></p></div><div class="subsection"><a name="EchoNonBlockingClient"></a><h3>EchoNonBlockingClient</h3><p>In the EchoBlockingClient once the "serviceCleint.sendReceive(payload);"
is called, the client is blocked till the operation is completed. This
behavior is not desirable when there are many Web Service invocations to be
done in a single client application. A solution would be to use a
@@ -163,8 +163,8 @@
invocations and provides the user with the flexibility to use Non Blocking
API for Web Service Clients.</p><p>To run the sample client ( EchoNonBlockingClient) you can simply use the
"testEchoNonBlockingClient" target of the ant file found at the
-"Axis2Home/samples" directory.</p></div><div class="subsection"><a name="EchoNonBlockingDualClient"></a><h3>EchoNonBlockingDualClient</h3><p>The solution provided by the Non-Blocking API has one limitation when it
-comes to Web Service invocations which takes long time to complete. The
+"Axis2Home/samples" directory.</p><p><a name="EchoNonBlockingDualClient"></a></p></div><div class="subsection"><a name="EchoNonBlockingDualClient"></a><h3>EchoNonBlockingDualClient</h3><p>The solution provided by the Non-Blocking API has one limitation when it
+comes to Web Service invocations which takes long time to complete. The
limitation is due to the use of single transport connection to invoke the Web
Service and to retrieve the response. In other words, client API provides a
non blocking invocation mechanism for the users, but the request and the
@@ -176,7 +176,7 @@
to be solved is the correlation (correlating the request and the response).
<a href="http://www.w3.org/Submission/ws-addressing/" class="newWindow" title="New Window" target="_blank">WS-Addressing</a> provides a neat solution to this using
<wsa:MessageID> and <wsa:RelatesTo> headers. Axis2 provides
-support for addressing based correlation mechanism and a complying Client
+support for addressing based correlation mechanism and a complying Client
API to invoke Web Services with two transport connections. (Core of Axis2
does not depend on WS-Addressing, but contains a set of parameters like in
addressing that can be populated in any means. WS-Addressing is one of the
@@ -246,7 +246,7 @@
need to "engage" addressing module in the server side as well. According to
the Axis2 architecture, addressing module is deployed in the
"<strong>pre-dispatch</strong>" phase (See <a href="Axis2ArchitectureGuide.html" class="newWindow" title="New Window" target="_blank">Architecture Guide</a> for
-more details about phases) and hence "engaging" means simply adding module
+more details about phases) and hence "engaging" means simply adding module
reference in the "axis2.xml" (NOT the "services.xml"). Now add the following
line to the "axis2.xml" that you can find in the "/webapps/axis2/WEB-INF"
directory in the servlet container. </p>
@@ -259,7 +259,7 @@
target of the ant file found at "Axis2Home/samples" directory. If you see the
response OMElement printed in the client side, then you have successfully
tested the Non Blocking API with two transport channels at the client
-side.</p></div><div class="subsection"><a name="EchoBlockingDualClient"></a><h3>EchoBlockingDualClient</h3><p>This is again a Two-Way transport request/response client, but this time,
+side.</p><p><a name="EchoBlockingDualClient"></a></p></div><div class="subsection"><a name="EchoBlockingDualClient"></a><h3>EchoBlockingDualClient</h3><p>This is again a Two-Way transport request/response client, but this time,
we use a Blocking API in the client code. Sample code for this can be found
in the "Axis2Home/samples/userguide/src/userguide/clients/" directory and the
explanation is similar to the <a href="#EchoNonBlockingDualClient">EchoNonBlockingDualClient</a>, except that
@@ -269,7 +269,7 @@
connections for request and response. User can test this client using the
"echoBlockingDualClient" target of the ant build file found in the
"Axis2Home/samples" directory.</p><p>See <a href="http-transport.html" class="newWindow" title="New Window" target="_blank">Configuring
-Transports</a> for use different transports.</p></div><div class="subsection"><a name="Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support"></a><h3>Writing Web Service Clients using Code Generation with Data Binding Support</h3><p>Axis2 provides the data binding support for Web Service client as well.
+Transports</a> for use different transports.</p><p><a name="Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support"></a></p></div><div class="subsection"><a name="Writing_Web_Service_Clients_using_Code_Generation_with_Data_Binding_Support"></a><h3>Writing Web Service Clients using Code Generation with Data Binding Support</h3><p>Axis2 provides the data binding support for Web Service client as well.
The user can generate the required stubs from a given WSDL with the other
supporting classes. Let's generate stubs for the WSDL used earlier to
generate the skeleton for the "Axis2SampleDocLitPortType". Simply run the
@@ -282,7 +282,7 @@
that can be used to invoke the Web Service Axis2SampleDocLitPortType. Let's
see how we can use this stub to write Web Service clients to utilize the Web
Service Axis2SampleDocLitPortType (the service that we have already
-deployed).</p></div><div class="subsection"><a name="Client_for_echoVoid_Operation"></a><h3>Client for echoVoid Operation</h3><p>Following code fragment shows the necessary code for utilizing the
+deployed).</p><p><a name="Client_for_echoVoid_Operation"></a></p></div><div class="subsection"><a name="Client_for_echoVoid_Operation"></a><h3>Client for echoVoid Operation</h3><p>Following code fragment shows the necessary code for utilizing the
echoVoid operation of the Axis2SampleDocLitPortType that we have already
deployed. In this operation, a blank SOAP body element is sent to the Web
Service and the same SOAP envelope is echoed back.</p>
@@ -296,9 +296,8 @@
} catch (Exception e) {
e.printStackTrace();
}
-
-</pre></div>
- </div><div class="subsection"><a name="Client_for_echoString_Operation"></a><h3>Client for echoString Operation</h3><p>Following code fragment shows the necessary code for utilizing the
+ </pre></div>
+ <p><a name="Client_for_echoString_Operation"></a></p></div><div class="subsection"><a name="Client_for_echoString_Operation"></a><h3>Client for echoString Operation</h3><p>Following code fragment shows the necessary code for utilizing the
echoString operation of the Axis2SampleDocLitPortType that we have already
deployed. The code is very simple to understand and the explanations are in
the form of comments.</p>
@@ -320,7 +319,7 @@
</pre></div>
<p>Similarly following code fragments show client side code for
-echoStringArray operation and echoStruct operation respectively.</p></div><div class="subsection"><a name="Client_for_echoStringArray_Operation"></a><h3>Client for echoStringArray Operation</h3>
+echoStringArray operation and echoStruct operation respectively.</p><p><a name="Client_for_echoStringArray_Operation"></a></p></div><div class="subsection"><a name="Client_for_echoStringArray_Operation"></a><h3>Client for echoStringArray Operation</h3>
<div class="source"><pre>try {
//Create the stub by passing the AXIS_HOME and target EPR.
//We pass null to the AXIS_HOME and hence the stub will use the current directory as the AXIS_HOME
@@ -346,9 +345,8 @@
} catch (Exception e) {
e.printStackTrace();
}
-
-</pre></div>
- </div><div class="subsection"><a name="Client_for_echoStruct_Operation"></a><h3>Client for echoStruct Operation</h3>
+ </pre></div>
+ <p><a name="Client_for_echoStruct_Operation"></a></p></div><div class="subsection"><a name="Client_for_echoStruct_Operation"></a><h3>Client for echoStruct Operation</h3>
<div class="source"><pre>try {
//Create the stub by passing the AXIS_HOME and target EPR.
//We pass null to the AXIS_HOME and hence the stub will use the current directory as the AXIS_HOME
Modified: webservices/axis2/site/0_94/userguide4.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/site/0_94/userguide4.html?rev=370524&r1=370523&r2=370524&view=diff
==============================================================================
--- webservices/axis2/site/0_94/userguide4.html (original)
+++ webservices/axis2/site/0_94/userguide4.html Thu Jan 19 08:22:01 2006
@@ -2,37 +2,36 @@
@import url("../style/maven-base.css");
@import url("../style/maven-theme.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/axis2/" id="projectLogo"><img alt="Apache Axis 2.0" src="http://ws.apache.org/axis2/images/axis.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 18 January 2006
- | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
+ Last published: 19 January 2006
+ | Doc for 0.95</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuAxis_2_0"><h5>Axis 2.0</h5><ul><li class="none"><a href="../index.html">Home</a></li><li class="expanded"><a href="../">Download Axis2</a><ul><li class="none"><a href="../download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/?root=Apache-SVN" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="../">Documentation</a><ul><li class="none"><a href="../0_93/index.html">Version 0.93</a></li><li class="none"><a href="../0_94/index.html">Version 0.94</a></li></ul></li><li class="expanded"><a href="../overview.html">Get Involved</a><ul><li class="none"><a href="../svn.html">Checkout the Source</a></li><li class="none"><a href="../siteHowTo.html">Build the Site</a></li><li class="none"><a href="../guidelines.html">Devel
oper Guidelines</a></li><li class="none"><a href="../refLib.html">Reference Library</a></li><li class="none"><a href="../mail-lists.html">Mailing Lists</a></li><li class="none"><a href="../faq.html">FAQ</a></li></ul></li><li class="none"><a href="../modules/index.html">Modules</a></li><li class="none"><a href="../thanks.html">Acknowledgements</a></li><li class="expanded"><a href="../">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="../issue-tracking.html">Issue Tracking</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><p><a name="Axis2_User_s_Guide"></a></p></div><div class="section"><a name="Axis2_User_s_Guide"></a><h2>Axis2 User's Guide</h2><p><i>Version 0.94</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" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>,
<a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>,<a href="userguide3.html" class="newWindow" title="New Window" target="_blank"> 3</a>, <b>4</b>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p><b><font size="4">Note (on samples):</font></b><p>All the user's guide samples
are located in the <b>"samples/userguide/src"</b> directory of the binary
distribution.
-
-</p></div><div class="section"><a name="Modules"></a><h2>Modules</h2><p>Axis2 provides an extended support for modules (See <a href="Axis2ArchitectureGuide.html" class="newWindow" title="New Window" target="_blank">Architecture Guide</a> for more details
+<a name="Modules"></a></p></div><div class="section"><a name="Modules"></a><h2>Modules</h2><p>Axis2 provides an extended support for modules (See <a href="Axis2ArchitectureGuide.html" class="newWindow" title="New Window" target="_blank">Architecture Guide</a> for more details
about modules in Axis2). Let's create a custom module and deploy it to the
MyService which we created earlier. Following steps shows the actions that
need to be performed to deploy a custom module for a given Web Service:</p><ol>
- <li><p style="margin-bottom: 0in">Create the Module Implementation</p>
+ <li>Create the Module Implementation
</li>
- <li><p style="margin-bottom: 0in">Create the Handlers</p>
+ <li>Create the Handlers
</li>
- <li><p style="margin-bottom: 0in">Create the module.xml</p>
+ <li>Create the module.xml
</li>
- <li><p style="margin-bottom: 0in">Modify the "axis2.xml" (if you need
- custom phases)</p>
+ <li>Modify the "axis2.xml" (if you need
+ custom phases)
</li>
- <li><p style="margin-bottom: 0in">Modify the "services.xml" to engage
- modules at the deployment time.</p>
+ <li>Modify the "services.xml" to engage
+ modules at the deployment time.
</li>
- <li><p style="margin-bottom: 0in">Package in a ".mar" (Module Archive)</p>
+ <li>Package in a ".mar" (Module Archive)
</li>
- <li><p>Deploy the module in Axis2</p>
+ <li>Deploy the module in Axis2
</li>
-</ol><div class="subsection"><a name="MyService_with_a_Logging_Module"></a><h3>MyService with a Logging Module</h3><p>Let's write a simple logging module for our sample. This module contains
+</ol><p><a name="MyService_with_a_Logging_Module"></a></p><div class="subsection"><a name="MyService_with_a_Logging_Module"></a><h3>MyService with a Logging Module</h3><p>Let's write a simple logging module for our sample. This module contains
one handler that just logs the message that is passed through it. Axis2 uses
."mar" (Module Archive) to deploy modules in Axis2. Following diagram shows
the file structure inside that needs to be there in the ".mar" archive. Let's
-create all these and see how it works.</p><p><img src="images/userguide/ModuleView.jpg" name="Graphic5" align="bottom" width="185" height="120" border="0" alt=""></img></p></div><div class="subsection"><a name="Step1_:_LoggingModule_Class"></a><h3>Step1 : LoggingModule Class</h3><p>LoggingModule is the implementation class of the Axis2 module. Axis2
+create all these and see how it works.</p><p><img src="images/userguide/ModuleView.jpg" name="Graphic5" align="bottom" width="185" height="120" border="0" alt=""></img></p><p><a name="Step1_:_LoggingModule_Class"></a></p></div><div class="subsection"><a name="Step1_:_LoggingModule_Class"></a><h3>Step1 : LoggingModule Class</h3><p>LoggingModule is the implementation class of the Axis2 module. Axis2
modules should implement the "org.apache.axis2.modules.Module" interface with
the following methods.</p>
<div class="source"><pre>public void init(AxisConfiguration axisSystem) throws AxisFault;//Initialize the module
@@ -43,7 +42,7 @@
termination. With the input parameter AxisConfiguration user is provided with
the complete configuration hierarchy. This can be used to fine-tune the
module behavior using the module writers. For the simple logging service we
-can keep these methods blank in our implementation class.</p></div><div class="subsection"><a name="Step2_:_LogHandler"></a><h3>Step2 : LogHandler</h3><p>A module in Axis2 can contain, one or more handlers that perform various
+can keep these methods blank in our implementation class.</p><p><a name="Step2_:_LogHandler"></a></p></div><div class="subsection"><a name="Step2_:_LogHandler"></a><h3>Step2 : LogHandler</h3><p>A module in Axis2 can contain, one or more handlers that perform various
SOAP header processing at different phases. (See<a href="Axis2ArchitectureGuide.html" class="newWindow" title="New Window" target="_blank"> Architecture Guide</a>
for more information about phases). For the logging module we will write a
handle with the following methods. "public void invoke(MessageContext ctx);"
@@ -70,9 +69,8 @@
this.name = name;
}
}
-
-</pre></div>
- </div><div class="subsection"><a name="Step3_:_module_xml"></a><h3>Step3 : module.xml</h3><p>"module.xml" contains the deployment configurations for a particular
+ </pre></div>
+ <p><a name="Step3_:_module_xml"></a></p></div><div class="subsection"><a name="Step3_:_module_xml"></a><h3>Step3 : module.xml</h3><p>"module.xml" contains the deployment configurations for a particular
module. It contains details such as Implementation class of the module (in
this example it is the "LoggingModule" class and various handlers that will
run in different phases). "module.xml" for the logging module will be as
@@ -105,17 +103,17 @@
</pre></div>
<p>As it can be seen there are four phases defined in this "module.xml"</p><ol>
- <li>inflow - Represents the handler chain that will run when
+ <li>inflow - Represents the handler chain that will run when
a message is coming in. </li>
- <li><p style="margin-bottom: 0in">outflow - Represents the
- handler chain that will run when the message is going out. </p>
+ <li>outflow - Represents the
+ handler chain that will run when the message is going out.
</li>
- <li><p style="margin-bottom: 0in">Outfaultflow - Represents the
+ <li>Outfaultflow - Represents the
handler chain that will run when there is a fault and the fault is going
- out </p>
+ out
</li>
- <li><p>INfaultflow - Represents the handler chain that will run when
- there is a fault and the fault is coming in </p>
+ <li>INfaultflow - Represents the handler chain that will run when
+ there is a fault and the fault is coming in
</li>
</ol><p>Following set of tags describe the name of the handler, handler class and
the phase in which this handler is going to run. "InFlowLogHandler" is the
@@ -130,7 +128,7 @@
</handler>
</pre></div>
- <p>To learn more on Phase rules, click on <a href="http://www.developer.com/java/web/article.php/3529321" class="newWindow" title="New Window" target="_blank">here</a></p></div><div class="subsection"><a name="Step_4:_Modify_the_"axis2_xml""></a><h3>Step 4: Modify the "axis2.xml"</h3><p>In this handler the phase "loggingPhase" is defined by the module writer.
+ <p>To learn more on Phase rules, click on <a href="http://www.developer.com/java/web/article.php/3529321" class="newWindow" title="New Window" target="_blank">here</a></p><p><a name="Step_4:_Modify_the_"axis2_xml""></a></p></div><div class="subsection"><a name="Step_4:_Modify_the_"axis2_xml""></a><h3>Step 4: Modify the "axis2.xml"</h3><p>In this handler the phase "loggingPhase" is defined by the module writer.
It is not a pre-defined handler phase, hence the module writer should
introduce it to the "axis2.xml" (NOT the services.xml) so that Axis2 engine
knows where to place the handler in different "flows" ( InFlow, OutFlow,
@@ -202,7 +200,7 @@
<p>Shown in green, the custom phase "loggingPhase" is placed in all the
flows, hence that phase will be called in all the message flows in the
engine. Since our module is associated with this phase, the LogHandler inside
-the module now will be executed in this phase.</p></div><div class="subsection"><a name="Step5_:_Modify_the_"services_xml""></a><h3>Step5 : Modify the "services.xml"</h3><p>Up to this point we have created the required classes and configuration
+the module now will be executed in this phase.</p><p><a name="Step5_:_Modify_the_"services_xml""></a></p></div><div class="subsection"><a name="Step5_:_Modify_the_"services_xml""></a><h3>Step5 : Modify the "services.xml"</h3><p>Up to this point we have created the required classes and configuration
descriptions for the logging module and by changing the "axis2.xml" we have
created the required phases for the logging module. Next step is to
"<b>engage</b>" (use) this module in one of our services. For this, let's use
@@ -234,21 +232,22 @@
ref="logging"/>"</b> to "services.xml". This informs the Axis2 engine that
the module "logging" should be engaged for this service. The handler inside
the module will be executed in their respective phases as described by the
-"module.xml".</p><p><b><a name="Step6_:_Packaging">Step6 : Packaging</a></b></p><p>Before deploying the module we need to create the ".mar" file for this
+"module.xml".</p><p><a name="Step6_:_Packaging"></a></p><p><b>Step6 : Packaging</b></p><p>Before deploying the module we need to create the ".mar" file for this
module. This can be done, using the "jar" command and then renaming the
created jar file. Or you can find the "Logging.mar" that is already created
-for you in the "Axis2Home/samples/userguide" directory.</p></div><div class="subsection"><a name="Step7_:_Deploy_the_Module_in_Axis2"></a><h3>Step7 : Deploy the Module in Axis2</h3><p>Deploying a module in Axis2 require the user to create a directory with
+for you in the "Axis2Home/samples/userguide" directory.</p><p><a name="Step7_:_Deploy_the_Module_in_Axis2"></a></p></div><div class="subsection"><a name="Step7_:_Deploy_the_Module_in_Axis2"></a><h3>Step7 : Deploy the Module in Axis2</h3><p>Deploying a module in Axis2 require the user to create a directory with
the name "modules" in the "webapps/axis2/WEB-INF" directory of their servlet
container and then copying the ".mar" file to that directory. So let's first
create the "modules" directory and drop the "LoggingModule.mar" in to this
directory.</p><p>Although the required changes to the "services.xml" is very little, we
have created a separate service archive (MyServiceWithModule.aar) for users
-to deploy and see. Deploy this service using the <a href="userguide2.html#Step4_:Deploy_the_Web_Service">same steps
-that you used to deploy "MyService"</a> and copy the "LoggingModule.mar" file
+to deploy and see. Deploy this service using the
+ <a href="userguide2.html#Step4_:Deploy_the_Web_Service">
+ same steps that you used to deploy "MyService"</a> and copy the "LoggingModule.mar" file
to the "modules" directory. Then run using the
"TestWebServiceWithModuleClient.bat" or "TestWebServiceWithModuleClient.sh"
in the "Axis2Home/samples/userguide/src/userguide/clients/bin" directory.</p><p>Note: To see the logs, the user needs to modify the "log4j.properties" to
log INFO. The property file is located in "webapps\axis2\WEB-INF\classes" of
your servlet container. Change the line "log4j.rootCategory= ERROR, LOGFILE"
-to "log4j.rootCategory=INFO, ERROR, LOGFILE".</p><p align="right"><a href="userguide3.html" class="newWindow" title="New Window" target="_blank"><img src="images/arrow_left.gif" alt=""></img> Previous</a> | <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">Next <img src="images/arrow_right.gif" alt=""></img></a></p><p>Pages: <a href="userguide.html" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>, <a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>,<a href="userguide3.html" class="newWindow" title="New Window" target="_blank"> 3</a>,
+to "log4j.rootCategory=INFO, ERROR, LOGFILE".</p><p align="right"><a href="userguide3.html" class="newWindow" title="New Window" target="_blank"><img alt="" src="images/arrow_left.gif"></img> Previous</a> | <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">Next <img src="images/arrow_right.gif" alt=""></img></a></p><p>Pages: <a href="userguide.html" class="newWindow" title="New Window" target="_blank">Content</a>, <a href="userguide1.html" class="newWindow" title="New Window" target="_blank">1</a>, <a href="userguide2.html" class="newWindow" title="New Window" target="_blank">2</a>,<a href="userguide3.html" class="newWindow" title="New Window" target="_blank"> 3</a>,
<b>4</b>, <a href="userguide5.html" class="newWindow" title="New Window" target="_blank">5</a></p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2006, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>