You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by ch...@apache.org on 2006/05/03 16:16:03 UTC
svn commit: r399313 - in /webservices/axis2/trunk/java/xdocs/1_0:
userguide.html userguide1.html userguide2.html userguide3.html
userguide4.html userguide5.html
Author: chatra
Date: Wed May 3 07:15:56 2006
New Revision: 399313
URL: http://svn.apache.org/viewcvs?rev=399313&view=rev
Log:
made corrections intructed by Ruchith and also added tool information to userguide1.html
Modified:
webservices/axis2/trunk/java/xdocs/1_0/userguide.html
webservices/axis2/trunk/java/xdocs/1_0/userguide1.html
webservices/axis2/trunk/java/xdocs/1_0/userguide2.html
webservices/axis2/trunk/java/xdocs/1_0/userguide3.html
webservices/axis2/trunk/java/xdocs/1_0/userguide4.html
webservices/axis2/trunk/java/xdocs/1_0/userguide5.html
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide.html Wed May 3 07:15:56 2006
@@ -11,10 +11,10 @@
<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>This document describes how to write Web Services and Web Service client
+using Axis2. It also describes how to write a custom module and engaging it
+within a Web Service. Samples shipped with the binary distribution of Axis2,
+is also discussed. It also contains a section on Advanced Topics.</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
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide1.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide1.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide1.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide1.html Wed May 3 07:15:56 2006
@@ -196,21 +196,21 @@
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>WSDL2WS- <a href="../tools/1_0/eclipse/wsdl2java-plugin.html"
+ target="_blank">eclipse plugin</a><a>/</a> <a
+ href="../tools/1_0/CodegenToolReference.html" target="_blank">Command
+ line version</a><a>/</a><a
+ href="../tools/1_0/idea/Idea_plug-in_userguide.html#WSDL2Java_Code_Generation"
+ target="_blank">IntelliJ IDEA plugin</a></li>
+ <li>Service Archive Wizard- <a
+ href="../tools/1_0/eclipse/servicearchiver-plugin.html"
+ target="_blank">eclipse plugin</a>/ <a
+ href="../tools/1_0/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>
+<p><a href="http://ws.apache.org/axis2/tools/index.html"
+target="_blank">Download</a> above plug-ins!</p>
<h3>What Still To Do?</h3>
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide2.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide2.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide2.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide2.html Wed May 3 07:15:56 2006
@@ -22,8 +22,8 @@
<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 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>
+samples mentioned in the user guide are located in the
+<b>"samples/userguide/src"</b> directory of the binary distribution.</p>
<h2><a name="Web_Services_Using_Axis2">Web Services Using Axis2</a></h2>
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide3.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide3.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide3.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide3.html Wed May 3 07:15:56 2006
@@ -21,8 +21,8 @@
href="userguide4.html">4</a>, <a href="userguide5.html">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
+guide we will look at how to write Web Service Clients using Axis2. All
+samples mentioned in the user guide 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>
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide4.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide4.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide4.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide4.html Wed May 3 07:15:56 2006
@@ -4,7 +4,6 @@
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Axis2 User's Guide</title>
- <meta name="generator" content="Bluefish 1.0.4">
</head>
<body lang="en-US" dir="ltr">
@@ -21,8 +20,8 @@
href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a
href="userguide3.html">3</a>, <b>4</b>, <a href="userguide5.html">5</a></p>
-<p><b><font size="4">Note (on samples):</font></b> All the user's guide
-samples are located in the <b>"samples/userguide/src"</b> directory of the
+<p><b><font size="4">Note (on samples):</font></b> All samples mentioned in
+the user guide are located at <b>"samples/userguide/src"</b> directory of the
binary distribution.</p>
<h2><a name="Modules"></a>Modules</h2>
@@ -67,28 +66,34 @@
<h4><a name="Step1_:_LoggingModule_Class">Step1 : LoggingModule Class</a></h4>
<p>LoggingModule is the implementation class of the Axis2 module. Axis2
-modules should implement the "<a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/modules/Module.java?rev=396785&view=log">org.apache.axis2.modules.Module</a>" interface with
-the following methods.</p>
+modules should implement the "<a
+href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/modules/Module.java?rev=396785&view=log">org.apache.axis2.modules.Module</a>"
+interface with the following methods.</p>
<pre>public void init(ConfigurationContext configContext, AxisModule module) throws AxisFault;//Initialize the module
public void shutdown(AxisConfiguration axisSystem) throws AxisFault;//End of module processing
public void engageNotify(AxisDescription axisDescription) throws AxisFault;</pre>
<p>These methods can be used to control the module initialization and the
-termination. With the input parameter AxisConfiguration, user is provided with
-the complete configuration hierarchy. This can be used to fine-tune the
-module behavior by the module writers. For the simple logging service we
-can keep these methods blank in our implementation class.</p>
+termination. With the input parameter AxisConfiguration, user is provided
+with the complete configuration hierarchy. This can be used to fine-tune the
+module behavior by the module writers. For the simple logging service we can
+keep these methods blank in our implementation class.</p>
<h4><a name="Step2_:_LogHandler">Step2 : LogHandler</a></h4>
<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" target="_blank"> Architecture Guide</a>
-for more information about phases). To write a handler one should implement <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/Handler.java?rev=357187&view=log">org.apache.axis2.engine.Handler</a>. But for convenience, <a href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java?rev=396788&view=log">org.apache.axis2.handlers.AbstractHandler</a> provides an abstract implementation of the Handler interface.
-For the logging module we will write a handler with the following methods. "public void invoke(MessageContext ctx);"
-is the method that is called by Axis2 engine when the control is passed to
-the handler. "public void revoke(MessageContext ctx);" is called when the
-handlers are revoked by the Axis2 engine.</p>
+for more information about phases). To write a handler one should implement
+<a
+href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/engine/Handler.java?rev=357187&view=log">org.apache.axis2.engine.Handler</a>.
+But for convenience, <a
+href="http://svn.apache.org/viewcvs.cgi/webservices/axis2/trunk/java/modules/core/src/org/apache/axis2/handlers/AbstractHandler.java?rev=396788&view=log">org.apache.axis2.handlers.AbstractHandler</a>
+provides an abstract implementation of the Handler interface. For the logging
+module we will write a handler with the following methods. "public void
+invoke(MessageContext ctx);" is the method that is called by Axis2 engine
+when the control is passed to the handler. "public void revoke(MessageContext
+ctx);" is called when the handlers are revoked by the Axis2 engine.</p>
<pre>public class LogHandler extends AbstractHandler implements Handler {
private Log log = LogFactory.getLog(getClass());
private QName name;
@@ -303,9 +308,9 @@
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 "logging.mar" file to the
-"modules" directory. Then run using the "TestWebServiceWithModuleClient.bat"
-or "TestWebServiceWithModuleClient.sh" in the
+to deploy "MyService"</a> and copy the "logging.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
Modified: webservices/axis2/trunk/java/xdocs/1_0/userguide5.html
URL: http://svn.apache.org/viewcvs/webservices/axis2/trunk/java/xdocs/1_0/userguide5.html?rev=399313&r1=399312&r2=399313&view=diff
==============================================================================
--- webservices/axis2/trunk/java/xdocs/1_0/userguide5.html (original)
+++ webservices/axis2/trunk/java/xdocs/1_0/userguide5.html Wed May 3 07:15:56 2006
@@ -21,8 +21,8 @@
href="userguide1.html">1</a>, <a href="userguide2.html">2</a>, <a
href="userguide3.html">3</a>, <a href="userguide4.html">4</a>, <b>5</b></p>
-<p><font size="4"><b>Note (on samples):</b></font> All the user's guide
-samples are located in the <b>"samples/userguide/src"</b> directory of the
+<p><font size="4"><b>Note (on samples):</b></font> All samples mentioned in
+the user guide are located at <b>"samples/userguide/src"</b> directory of the
binary distribution.</p>
<h2><a name="Other_Samples">Other Samples</a></h2>