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 ha...@apache.org on 2005/12/19 16:43:34 UTC
svn commit: r357711 [2/4] - in /webservices/axis/trunk/c/docs: ./ arch/
Modified: webservices/axis/trunk/c/docs/arch/handler.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/arch/handler.html?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
--- webservices/axis/trunk/c/docs/arch/handler.html (original)
+++ webservices/axis/trunk/c/docs/arch/handler.html Mon Dec 19 07:43:10 2005
@@ -2,7 +2,6 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<!--*** This is a generated file. Do not edit. ***-->
<link rel="stylesheet" href="../../skin/tigris.css" type="text/css">
<link rel="stylesheet" href="../../skin/mysite.css" type="text/css">
<link rel="stylesheet" href="../../skin/site.css" type="text/css">
@@ -10,25 +9,19 @@
<title>Handler Tutorial</title>
</head>
<body bgcolor="white" class="composite">
-<!--================= start Banner ==================-->
<div id="banner">
<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
<tbody>
<tr>
-<!--================= start Group Logo ==================-->
<td align="left">
<div class="groupLogo">
<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../../images/project-logo.jpg"></a>
</div>
-</td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td align="right">
+</td><td align="right">
<div class="projectLogo">
<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../../images/axis.jpg"></a>
</div>
-</td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
+</td><td valign="top" rowspan="2" align="right" class="search">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0">
<tr>
@@ -51,34 +44,24 @@
</table>
</form>
</td>
-<!--================= end Search ==================-->
</tr>
</tbody>
</table>
</div>
-<!--================= end Banner ==================-->
-<!--================= start Main ==================-->
<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
<tbody>
-<!--================= start Status ==================-->
<tr class="status">
-<td>
-<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
-<!--================= end BreadCrumb ==================--></td><td id="tabs">
-<!--================= start Tabs ==================-->
+<td><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a></td><td id="tabs">
<div class="tab">
<span class="selectedTab"><a class="base-selected" href="../../index.html">WebServices-Axis</a></span>
</div>
-<!--================= end Tabs ==================-->
</td>
</tr>
</tbody>
</table>
-<!--================= end Status ==================-->
<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
<tbody>
<tr valign="top">
-<!--================= start Menu ==================-->
<td id="leftcol">
<div id="navcolumn">
<div class="menuBar">
@@ -86,13 +69,12 @@
<span class="menuLabel">Axis</span>
<div class="menuItem">
-<a href="../../index.html">Introduction</a>
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
</div>
<div class="menuItem">
-<a href="../../news.html">News</a>
+<a href="http://ws.apache.org/axis/news.html">News</a>
</div>
-
<div class="menuItem">
<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
@@ -102,27 +84,27 @@
<span class="menuLabel">Get Involved</span>
<div class="menuItem">
-<a href="../../overview.html">Overview</a>
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
</div>
<div class="menuItem">
-<a href="../../cvs.html">CVS Repository</a>
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
</div>
<div class="menuItem">
-<a href="../../mail.html">Mailing Lists</a>
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
</div>
<div class="menuItem">
-<a href="../../ref.html">Reference Library</a>
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
</div>
<div class="menuItem">
-<a href="../../bugs.html">Bugs</a>
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
</div>
<div class="menuItem">
-<a href="../../howtobuild.html">HowToBuildSite</a>
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
</div>
</div>
@@ -131,39 +113,39 @@
<span class="menuLabel">Axis (Java)</span>
<div class="menuItem">
-<a href="../../java/index.html">Documentation</a>
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
</div>
<div class="menuItem">
-<a href="../../java/install.html">Installation</a>
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
</div>
<div class="menuItem">
-<a href="../../java/user-guide.html">User's Guide</a>
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/developers-guide.html">Developer's Guide</a>
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/integration-guide.html">Integration Guide</a>
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/architecture-guide.html">Architecture Guide</a>
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/reference.html">Reference Guide</a>
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/reading.html">Reading Guide</a>
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/requirements.html">Requirements</a>
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
</div>
</div>
@@ -172,7 +154,7 @@
<span class="menuLabel">Axis (C++)</span>
<div class="menuItem">
-<a href="../../cpp/index.html">Latest Axis C++ Release!</a>
+<a href="../../cpp/index.html">Home</a>
</div>
<div class="menuItem">
@@ -197,11 +179,11 @@
<span class="menuLabel">Downloads</span>
<div class="menuItem">
-<a href="../../releases.html">Releases</a>
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
</div>
<div class="menuItem">
-<a href="../../interim.html">Interim Drops</a>
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
</div>
<div class="menuItem">
@@ -214,7 +196,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
</div>
</div>
@@ -244,23 +226,19 @@
<span class="menuLabel">Misc</span>
<div class="menuItem">
-<a href="../../site.html">Whole Site</a>
-</div>
-
-<div class="menuItem">
-<a href="../../who.html">Who We Are</a>
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
</div>
<div class="menuItem">
-<a href="../../contact.html">Contact</a>
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
</div>
<div class="menuItem">
-<a href="../../legal.html">Legal</a>
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
</div>
<div class="menuItem">
-<a href="../../docs.html">Notes/Docs</a>
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
</div>
</div>
@@ -269,9 +247,7 @@
</div>
</div>
</div>
-</td>
-<!--================= end Menu ==================-->
-<!--================= start Content ==================--><td>
+</td><td>
<div id="bodycol">
<div class="app">
<div align="center">
@@ -279,295 +255,163 @@
</div>
<div class="h3">
<div class="h3">
-<h3>Handler Tutorial</h3>
+<h3>Contents</h3>
+</div>
+<ul>
+<li>
+<a href="#Introduction">Introduction to Handlers</a>
+</li>
+<li>
+<a href="#Samples">Handler Samples</a>
+</li>
+<li>
+<a href="#ServerHandlerSample">Server sample handler</a>
+</li>
+<li>
+<a href="#ClientHandlerSample">Client sample handler</a>
+</li>
+<li>
+<a href="#HandlerAPIs">Handler API's</a><a href="#ClientHandlerSample"></a>
+</li>
+</ul>
+<div class="h3">
+<h3>Introduction to Handlers</h3>
</div>
<p>
-<a href="#linux">For Linux</a>
-<br>
-<br>
-<a href="#windows">For Windows</a>
-<br>
-<br>
-</p>
-<br>
-<p>
-<a name="#linux"></a>
-</p>
+<a name="Introduction"></a>Handlers are pluggable components in Axis C++. Handlers are pieces of code that you write to intercept the message either on the client or service side. We have included a set of sample handlers for your reference.<br> You can write your own handlers by following the instructions given for the sample Handlers. At the end of this section we have also added some more detailed API information.</p>
<div class="h3">
-<h3>Linux</h3>
+<h3>Handler samples</h3>
</div>
<p>
-<a href="#introduction">Introduction to Handlers</a>
+<a name="Samples"></a>We have included the following sample Handlers for your reference.</p>
+<ol>
+<li>
+<a href="#ServerHandlerSample">echoStringHeaderHandler</a> (A server side handler sample) This sample handler will simply echo (i.e send back) the string which you send in the SOAP Header in the SOAP request.</li>
+<li>
+<a href="#ClientHandlerSample">testHandler</a> (A client side handler sample) This sample handler will simply add a SOAP Header to the generated SOAP request.</li>
+</ol>
<br>
<br>
-<a href="#sample">Sample Handlers (building, running)</a>
-<br>
-<br>
-<a href="#creating">Creating your own Handlers</a>
-<br>
-<br>
-<a href="#API">API Notes for Handler writers</a>
-<br>
-<br>
-</p>
-<p></p>
-<p>Handlers are pluggable components in Axis C++. We have included a set of sample handlers for your reference. You could write your own handlers by following the instructions given for the sample Handlers.<br>
-<br>
-<strong>Note: If you are using Client side Handlers you need to enter the following entry to the [Axis_Folder]/axiscpp.conf configuration file.</strong>
-<br>
-<br>ClientWSDDFilePath:xxx<br>
-<br>Here xxx should be the path to the “client.wsdd” file.<br>
-</p>
-<p>
-<a name="#sample"></a>
-</p>
+<div class="h3">
+<h3>echoStringHeaderHandler (A server side handler sample)</h3>
+</div>
<p>
-<strong>Testing the sample Handlers</strong>
-</p>
-<br>
-<p>We have included the following sample Handlers for your reference.<br>
-<br> 1) echoStringHeaderHandler (A server side handler sample)<br> This sample handler will simply echo (i.e send back) the string which you send in the SOAP Header in the SOAP request.<br>
-<br>2)testHandler (A client side handler sample)<br>
-<br> This sample handler will simply add a SOAP Header to the generated SOAP request.<br>
-<br> Please note that these are very primitive sample handlers and are presented here to give you an idea about writing your own Handlers.<br>
+<a name="ServerHandlerSample"></a>
</p>
-<p>
-<strong>echoStringHeaderHandler</strong>
+<div class="h4">
+<h4>Building the echoStringHeaderHandler</h4>
+</div>
+<div class="h2">
+<h2>Linux</h2>
+</div>
+<pre class="code">The build files are available at</pre>
+<pre class="code"><Axis install directory>/samples/server/echoStringHeaderHandler Change your current directory to this directory and then execute the following... makemake install</pre>
+<pre class="code">The handler libeshhandler.so file will be created at <Axis install directory>/lib directory</pre>
+<div class="h2">
+<h2>Windows</h2>
+</div>
+<pre class="code">The VC dsw file (ServerHandlers.dsw) is available at</pre>
+<pre class="code"><Axis Install directory>/vc/samples/server/ ServerHandlers.dsw.</pre>
+<pre class="code">Open this file and build the project echoStringHeaderHandler. Once the build is successful you will find the DLL ( echoStringHeaderHandler.dll) at<Axis install directory>/bin</pre>
+<div class="h4">
+<h4>Configuring the echoStringHeader Handler</h4>
+</div>
+<p>Edit the server.wsdd file <a href="../install-guide.html#Server installation and configuration">(as created when you configured your server</a> <a href="../serveruser-guide.html">)</a> to include the handler for a particular service.<br>In this instance we are using the Calculator server example that we have used in both the client and server setup examples. The example below shows how a linux file would look e.g. libeshhandler.so is used please vary the file according to the libraries you have created. This example shows the handler being deployed on both the incoming and outgoing message.</p>
+<p><service name="Calculator" provider="CPP:RPC" description="Simple Calculator Axis C++ Service "><br>
+<strong> <requestFlow name="CalculatorHandlers"> <handler name="ESHHandler" type="<Axis installation directory>/handlers/custom/echoStringHeaderHandler/libeshhandler.so"> </handler> </requestFlow> <responseFlow name="CalculatorHandlers"> <handler name="ESHHandler" type="<Axis installation directory>AXISCPP_DEPLOY/lib/libeshhandler.so"> </handler> </responseFlow></strong>
<br>
+<br> <parameter name="allowedMethods" value="add sub mul div "/><br> <parameter name="className" value="<Axis installation directory>/webservices/libcalculator.so" /><br> </service><br>
+<strong>Note:</strong> Make sure you specify the correct path of the handler so in the server.wsdd file.<br>
+<br> Now you are almost ready to run your server-side handler.<br> You have to restart the Apache server so that it picks up its new configuration and then that's it !</p>
+<div class="h4">
+<h4>Running the echoStringHeader Handler</h4>
+</div>
+<p>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when a client sends a SOAP request to the Calculator web service. Use the <a href="clientuser-guide.html#Generating and using client stubs">calculator client</a> you created earlier.</p>
<br>
-<strong>Building the Sample Handlers in RedHat linux</strong>
<br>
-<br>
-<strong>Building echoStringHeaderHandler</strong> (A server side handler sample)<br>
-<br>The build files are available at<br>
-<br>AXISCPP_HOME/samples/server/echoStringHeaderHandler.<br>Change your current directory to this directory and then you could execute the following.<br>
-<br> make<br>
-<br> make install<br>
-<br>The handler so file will be created at $AXISCPP_DEPLOY/lib directory<br>
-<br>
-<strong>Configuring the Handler</strong>
<br>
-<br>Now edit the AXISCPP_DEPLOY/etc/server.wsdd to include the handler for a particular service.<br>
<br>
-</p>
-<p><service name="Calculator" provider="CPP:RPC" description="Simple Calculator Axis C++ Service "><br><requestFlow name="CalculatorHandlers"><br><handler name="ESHHandler" type="AXIS_HOME/handlers/custom/echoStringHeaderHandler/libeshhandler.so"><br></handler><br></requestFlow><br><responseFlow name="CalculatorHandlers"><br><handler name="ESHHandler" type="AXISCPP_DEPLOY/lib/libeshhandler.so"><br></handler><br></responseFlow><br><parameter name="allowedMethods" value="add sub mul div "/><br><parameter name="className" value="Axis\webservices\Calculator.dll" /><br></service><br>
-</p>
+<div class="h3">
+<h3>testHandler (A client side handler sample)</h3>
+</div>
<p>
-<strong>Note:</strong> Make sure you specify the correct path of the handler so in the server.wsdd file. Replace the AXISCPP_DEPLOY with the exact relative path which AXISCPP_DEPLOY points to. (eg: type="/usr/local/axiscpp_deploy/etc/libeshhandler.so )<br>
-<br>Now you are almost done to run your server side handler.<br>Restart the Apache server and that's it.<br>
-<br>
-<strong>Running the Handler</strong>
-<br>
-<br>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when a client send a SOAP request to the Calculator web service.<br>
-<br>
-<strong>testHandler</strong>
-<br>
-<br>
-<strong>Building the Sample Handlers in RedHat linux</strong>
+<a name="ClientHandlerSample"></a>
+</p>
+<div class="h4">
+<h4>Building the testHandler</h4>
+</div>
+<p>The build files are available at <strong><Axis installation directory>/samples/client/testHandler</strong>. Change your current directory to this direcotory and then you could execute the following.</p>
+<div class="h2">
+<h2>linux</h2>
+</div>
+<pre class="code">makemake install</pre>
+<pre class="code">The handler so file will be created at <Axis installation directory>/lib/</pre>
+<div class="h2">
+<h2>windows</h2>
+</div>
+<pre class="code">The VC dsw file (ClientHandlers.dsw) is available at <Axis Installation directory>/vc/samples/client/ClientHandlers.dsw.Open this file and build the project TestHandler.</pre>
+<pre class="code">Once the build is successful you will find the DLL testHandler.dll) at <Axis Installation directory>/bin. If you see this DLL at the above location you are done with the first step.</pre>
<br>
-<br>
-<strong>Building testHandler</strong> (A client side handler sample)<br>
-<br>The build files are available at AXISCPP_HOME/samples/client/testHandler. Change your current directory to this direcotory and then you could execute the following.<br>
-<br> make<br>
-<br> make install<br>
-<br>The handler so file will be created at $AXISCPP_DEPLOY/lib/.<br>
-<br>
-<strong>Configuring the Handler</strong>
<br>
-<br> Now edit the AXISCPP_DEPLOY/etc/client.wsdd to include the handler for a particular service.</p>
-<p><service name="Calculator" provider="CPP:RPC" description="Calculator web service"><br><requestFlow name="CalculatorHandlers"><br><handler name="TestHandler" type="AXISCPP_DEPLOY/lib/libtest_client_handler.so"><br></handler><br></requestFlow><br></service></p>
+<div class="h4">
+<h4>Configuring the testHandler</h4>
+</div>
+<p>Now edit the <strong><Axis installation directory>/etc/client.wsdd</strong> to include the handler for a particular service.</p>
+<p>In this example we will continue to use the Calculator service. The sample wsdd file outlined below shows a linux directory system - for other operating systems please use the correct path symbols.<br>
+<strong>Note:</strong> Up until this point you did not need a client wsdd file the client only requires a wsdd file when it has handlers.</p>
<p>
-<strong>Note:</strong> Make sure you specify the correct path of the handler so in the client.wsdd file. Replace the AXISCPP_DEPLOY with the exact relative path which AXISCPP_DEPLOY points to. (eg: type="/usr/local/axiscpp_deploy/lib/libtest_client_handler.so)<br>
-<br> Now you are almost done to run your client side handler.<br>
+<strong><service name="Calculator" provider="CPP:RPC" description="Calculator web service"> <requestFlow name="CalculatorHandlers"> <handler name="TestHandler" type="<Axis Installation directory>/lib/libtest_client_handler.so"> </handler> </requestFlow> </service></strong>
+</p>
<br>
-<strong>Note:</strong> If you are using Client side Handlers you need to enter the entry in the AXISCPP_DEPLOY/etc/axiscpp.conf configuration file. (See above)<br>
<br>
-<strong>Running the Handler</strong>
+<strong>Note:</strong><strong>ClientWSDDFilePath</strong><a href="install-guide#Installing Client">axiscpp.conf</a>
<br>
-<br>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when you run the calculator web service client. (It is at AXISCPP_DEPLOY/bin/calculator )</p>
-<p>
-<a name="#creating"></a>
-</p>
-<p>
-<strong>Handler Notes:</strong>
-<br>1) You can see the Handler behavior through the TCP Monitor. (TCP Monitor is a Axis Java tool)<br>2) To get an idea of Handlers look at the Handler sample source files.<br> a. echoStringHeaderHandler (AXISCPP_HOME/samples/server/echoStringHeaderHandler)<br> b. testHandler (AXISCPP_HOME/samples/client/testHandler)</p>
-<p>
-<a name="#API"></a>
-</p>
<br>
-<p>
-<strong>The Handler API and details for Handler writers</strong>
<br>
-<br> Now you have seen some sample Handlers so that you can explore more on Handlers. The following sections helps you for the same.<br>
+<div class="h4">
+<h4>Running the testHandler</h4>
+</div>
+<p>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when you run the <a href="clientuser-guide.html#Generating and using client stubs">calculator web service client</a>..</p>
+<div class="h3">
+<h3>The Handler API's</h3>
+</div>
+<p>
+<a name="HandlerAPIs"></a>Now you have seen some sample Handlers you can explore more on Handlers. The following sections should help you understand that API's available to you in your handler code.<br>
<br> In order to get access to the DeSerializer the handler writer can use the following code block.<br>
<br>
</p>
-<p>// -----<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>.....<br>-------//<br>
+<p>// -----<br> .....<br> IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br> pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br> .....<br> -------//<br>
<br>
</p>
<p>In order to get access to a incoming HeaderBlock the handler writer can use the following code block.<br>
-<br> // -----<br>.....<br>IHeaderBlock* pIHeaderBlock= pIHandlerSoapDeSerializer->getHeaderBlock("echoMeString", "http://soapinterop.org/echoheader/");<br>.....<br>-------//</p>
+<br> // -----<br> .....<br> IHeaderBlock* pIHeaderBlock= pIHandlerSoapDeSerializer->getHeaderBlock("echoMeString", "http://soapinterop.org/echoheader/");<br> .....<br> -------//</p>
<p>In order to manipulate the above accessed HeaderBlock the handler writer can use the following code block.<br>
-<br> // -----<br>.....<br>if (pIHeaderBlock != NULL) {<br>
+<br> // -----<br> .....<br> if (pIHeaderBlock != NULL) {<br>
<br> const BasicNode* pBasicNode= pIHeaderBlock->getFirstChild();<br>
<br> const AxisChar* pachHeaderValue;<br>
-<br> if (pBasicNode != NULL)<br> {<br> if((pBasicNode->getNodeType()) == CHARACTER_NODE) {<br> pachHeaderValue= pBasicNode->getValue();<br> } else {<br> pachHeaderValue = "This was not the expected value Ros";<br> }<br> } else<br> {<br> pachHeaderValue = "pBascNode is NULL";<br> }<br>
-<br> AxisChar* pachTmpValue = (AxisChar*) malloc(strlen(pachHeaderValue) + 4);<br> strcpy(pachTmpValue, pachHeaderValue);<br>
-<br> pachTemp = "EchoStringHeaderHandlerPr1.id";<br> pIMsg->setProperty(pachTemp, pachTmpValue);<br>
+<br> if (pBasicNode != NULL)<br> {<br> if((pBasicNode->getNodeType()) == CHARACTER_NODE) {<br> pachHeaderValue= pBasicNode->getValue();<br> } else {<br> pachHeaderValue = "This was not the expected value Ros";<br> }<br> } else<br> {<br> pachHeaderValue = "pBascNode is NULL";<br> }<br>
+<br> AxisChar* pachTmpValue = (AxisChar*) malloc(strlen(pachHeaderValue) + 4);<br> strcpy(pachTmpValue, pachHeaderValue);<br>
+<br> pachTemp = "EchoStringHeaderHandlerPr1.id";<br> pIMsg->setProperty(pachTemp, pachTmpValue);<br>
<br> free(pachTmpValue);<br>
<br> } else {<br>
-<br> //do some thing<br> //AxisChar* pachTmpValue = "Default values since no reqeust SOAP header";<br> //pachTemp = "EchoStringHeaderHandlerPr1.id";<br> //pIMsg->setProperty(pachTemp, pachTmpValue);<br>
-<br> //free(pachTmpValue);<br> }<br>
+<br> //do some thing<br> //AxisChar* pachTmpValue = "Default values since no reqeust SOAP header";<br> //pachTemp = "EchoStringHeaderHandlerPr1.id";<br> //pIMsg->setProperty(pachTemp, pachTmpValue);<br>
+<br> //free(pachTmpValue);<br> }<br>
</p>
-<p>.....<br>-------//<br>
+<p>.....<br> -------//<br>
<br> In order to get access to the incoming SOAP Body the handler writer can use the following code block.<br>
<br> To get the body as a AxisChar*<br>
<br> // -----<br>
-<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>AxisChar* pSoapBody = pIHandlerSoapDeSerializer->getBodyAsChar();<br>.....<br>-------//<br>
-<br> To get the body as a decoded base64 stream.<br>// -----<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>xsd__base64Binary bb = pIHandlerSoapDeSerializer-&gtgetBodyAsBase64Binary();<br>.....<br>-------//</p>
+<br> .....<br> IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br> pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br> AxisChar* pSoapBody = pIHandlerSoapDeSerializer->getBodyAsChar();<br> .....<br> -------//<br>
+<br> To get the body as a decoded base64 stream.<br> // -----<br> .....<br> IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br> pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br> xsd__base64Binary bb = pIHandlerSoapDeSerializer-&gtgetBodyAsBase64Binary();<br> .....<br> -------//</p>
<p>
<strong>Notes:</strong>
-<br>Have a look at the following classes at the API docs to see all the available functions and their respective descriptions. (You can even look at the relevent .h/.hpp header files for the API comments)<br>IhandlerSoapDeSerializer<br>IHeaderBlock<br>BasicNode<br>
+<br> Have a look at the following classes at the API docs to see all the available functions and their respective descriptions. (You can even look at the relevent .h/.hpp header files for the API comments)<br> IhandlerSoapDeSerializer<br> IHeaderBlock<br> BasicNode<br>
</p>
<p>The BasicNode API is similar (not exactly the same, but ..) to the DOM and is written as a tree traversing API.<br>
<br> With the sample code samples provided above and with the API notes a developer will easily be able to write and play around his/her own Handlers.<br>
-<br> This tutorial will be updated frequently with the new additions and specially with your suggestions.<br>
-<br>
</p>
-<p>
-<a name="#windows"></a>
-</p>
-<div class="h3">
-<h3>Windows</h3>
-</div>
-<br>
-<br>
-<p>
-<a href="#introd">Introduction to Handlers</a>
-<br>
-<br>
-<a href="#sam">Sample Handlers (building, running)</a>
-<br>
-<br>
-<a href="#create">Creating your own Handlers</a>
-<br>
-<br>
-<a href="#APP">API Notes for Handler writers</a>
-<br>
-<br>
-</p>
-<p></p>
-<p>Handlers are pluggable components in Axis C++. We have included a set of sample handlers for your reference.<br>
-<br>You could write your own handlers by following the instructions given for the sample Handlers.<br>
-<br>
-<strong>Note: If you are using Client side Handlers you need to enter the following entry to the [Axis_Folder]/axiscpp.conf configuration file.</strong>
-<br>
-<br>ClientWSDDFilePath:Axis\conf\client.wsdd<br>
-<br>After entering this entry to your [Axis_Folder]/axiscpp.conf configuration file will look like:<br>
-<br>LogPath:Axis\logs\AxisLog.txt<br>WSDDFilePath:Axis\conf\server.wsdd<br>ClientWSDDFilePath:Axis\conf\client.wsdd<br>
-<br>
-</p>
-<p>
-<a name="#sam"></a>
-</p>
-<p>
-<strong>Testing the sample Handlers</strong>
-<br>
-<br>We have included the following sample Handlers for your reference.<br>
-<br>1) <strong>echoStringHeaderHandler</strong> (A server side handler sample)<br>
-<br>This sample handler will simply echo (i.e send back) the string which you send in the SOAP Header in the SOAP request.<br>
-<br>2)<strong>testHandler</strong> (A client side handler sample)<br>
-<br>This sample handler will simply add a SOAP Header to the generated SOAP request.<br>Please note that these are very primitive sample handlers and are presented here to give you an idea about writing your own Handlers.<br>
-<br>
-<strong>echoStringHeaderHandler</strong>
-<br>
-<br>
-<strong>Building the Sample Handlers in VC</strong>
-<br>
-</p>
-<p>
-<strong>Building echoStringHeaderHandler</strong> (A server side handler sample)<br>
-<br>The VC dsw file (ServerHandlers.dsw) is available at Axis_Extract/vc/samples/server/ ServerHandlers.dsw.<br>Open this file and build the project echoStringHeaderHandler. Once the build is successful you will find the DLL (echoStringHeaderHandler.dll) at Axis_Extract/bin.<br> If you see this DLL at the above location you are done with the first step.<br>
-<br>
-<strong>Configuring the Handler</strong>
-<br>
-<br>Now edit the [Axis_Folder]/conf/server.wsdd to include the handler for a particular service.<br>
-</p>
-<p><service name="Calculator" provider="CPP:RPC" description="Simple Calculator Axis C++ Service "><br><requestFlow name="CalculatorHandlers"><br><handler name="ESHHandler" type="[Axis_Extract]/bin/echoStringHeaderHandler.dll"><br></handler><br></requestFlow><br><responseFlow name="CalculatorHandlers"><br><handler name="ESHHandler" type="[Axis_Extract]/bin/echoStringHeaderHandler.dll"><br></handler><br></responseFlow><br><parameter name="allowedMethods" value="add sub mul div "/><br><parameter name="className" value="Axis\webservices\Calculator.dll" /><br></service><br>
<br>
-<strong>Note:</strong> Make sure you specify the correct path of the handler dll in the server.wsdd file.<br>Now you are almost done to run your server side handler.<br>Restart the Apache server.<br>
<br>
-</p>
-<p>
-<strong>Running the Handler</strong>
-<br>
-<br>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when a client send a SOAP request to the Calculator web service.<br>
-<br>
-<strong>testHandler</strong>
-<br>
-<br>
-<strong>Building the Sample Handlers in VC</strong>
-<br>
-<br>
-<strong>Building testHandler</strong> (A client side handler sample)<br>
-<br>The VC dsw file <strong>(ClientHandlers.dsw)</strong> is available at Axis_Extract/vc/samples/client/ClientHandlers.dsw.Open this file and build the project TestHandler.<br>Once the build is successful you will find the DLL testHandler.dll) at Axis_Extract/bin. If you see this DLL at the above location you are done with the first step.<br>
-<br>
-<strong>Configuring the Handler</strong>
-<br>
-<br>Now edit the [Axis_Folder]/conf/client.wsdd to include the handler for a particular service.<br>
-</p>
-<p><service name="Calculator" provider="CPP:DOCUMENT" description="Calculator web service"><br><requestFlow name="CalculatorHandlers"><br><handler name="TestHandler" type="[Axis_Extract]/bin/testHandler.dll"><br></handler><br></requestFlow><br></service></p>
-<p>
-<strong>Note:</strong> Make sure you specify the correct path of the handler dll in the client.wsdd file.<br>Now you are almost done to run your client side handler.<br>
-<br>
-<strong>Note: If you are using Client side Handlers you need to enter the ClientWSDDFilePath entry in the [Axis_Folder]/axiscpp.conf configuration file. (See above)</strong> Running the Handler<br>
-<br>Since this Handler is configured to the Calculator web service in the above step, this Handler will be executed when you run the calculator web service client. (It is at [Axis_Extract]/bin/Calculator.exe)<br>
-<br>
-</p>
-<p>
-<a name="#create"></a>
-</p>
-<p>Handler Notes:<br>
-<br>1) You can see the Handler behavior through the TCP Monitor. (TCP Monitor is a Axis Java tool)<br>
-<br>2) To get an idea of Handlers look at the Handler sample source files.<br>
-<br>a. echoStringHeaderHandler ([Axis_Extract]/samples/server/echoStringHeaderHandler)<br>
-<br>b. testHandler ([Axis_Extract]/samples/client/testHandler)<br>
-<br>
-</p>
-<p></p>
-<p>
-<strong>The Handler API and details for Handler writers</strong>
-<br>
-<br> Now you have seen some sample Handlers so that you can explore more on Handlers. The following sections helps you for the same.<br>
-<br> In order to get access to the DeSerializer the handler writer can use the following code block.<br>
-<br>
-</p>
-<p>// -----<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>
-<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>
-<br>.....<br>-------//<br>
-<br> In order to get access to a incoming HeaderBlock the handler writer can use the following code block.<br>
-<br> // -----<br>.....<br>IHeaderBlock* pIHeaderBlock= pIHandlerSoapDeSerializer->getHeaderBlock("echoMeString", "http://soapinterop.org/echoheader/");<br>.....<br>-------//<br>
-</p>
-<p>In order to manipulate the above accessed HeaderBlock the handler writer can use the following code block.<br>
-<br> // -----<br>.....<br>if (pIHeaderBlock != NULL) {<br>
-<br> const BasicNode* pBasicNode= pIHeaderBlock->getFirstChild();<br> const AxisChar* pachHeaderValue;<br>
-<br> if (pBasicNode != NULL)<br> {<br> if((pBasicNode->getNodeType()) == CHARACTER_NODE) {<br> pachHeaderValue= pBasicNode->getValue();<br> } else {<br> pachHeaderValue = "This was not the expected value Ros";<br> }<br> } else<br> {<br> pachHeaderValue = "pBascNode is NULL";<br> }<br>
-<br> AxisChar* pachTmpValue = (AxisChar*) malloc(strlen(pachHeaderValue) + 4);<br> strcpy(pachTmpValue, pachHeaderValue);<br>
-<br> pachTemp = "EchoStringHeaderHandlerPr1.id";<br> pIMsg->setProperty(pachTemp, pachTmpValue);<br>
-<br> free(pachTmpValue);<br>
-<br> } else {<br> //do some thing<br> //AxisChar* pachTmpValue = "Default values since no reqeust SOAP header";<br> //pachTemp = "EchoStringHeaderHandlerPr1.id";<br> //pIMsg->setProperty(pachTemp, pachTmpValue);<br> //free(pachTmpValue);<br> }<br>
-<br> ....<br> -------//<br>
-</p>
-<p>In order to get access to the incoming SOAP Body the handler writer can use the following code block.<br>
-<br> To get the body as a AxisChar*<br> // -----<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>AxisChar* pSoapBody = pIHandlerSoapDeSerializer->getBodyAsChar();<br>.....<br>-------//<br>
-<br> To get the body as a decoded base64 stream.<br>// -----<br>.....<br>IHandlerSoapDeSerializer* pIHandlerSoapDeSerializer;<br>pIMsg->getSoapDeSerializer(&pIHandlerSoapDeSerializer);<br>xsd__base64Binary bb = pIHandlerSoapDeSerializer->getBodyAsBase64Binary();<br>.....<br>-------//</p>
-<p>
-<strong>Note:</strong>
-<br>
-<br> Have a look at the following classes at the API docs to see all the available functions and their respective descriptions. (You can even look at the relavent .h/.hpp header files for the API comments)<br>1.IhandlerSoapDeSerializer<br>2.IHeaderBlock<br>3.BasicNode<br>
-<br> The BasicNode API is similar (not exactly the same, but ..) to the DOM and is written as a tree traversing API.<br>
-<br> With the sample code samples provided above and with the API notes a developer will easily be able to write and play around his/her own Handlers.<br>
-<br> This tutorial will be updated frequently with the new additions and specially with your suggestions.</p>
<div id="pdf" align="right">
<a href="handler.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
PDF</a>
@@ -576,40 +420,30 @@
</div>
</div>
</td>
-<!--================= end Content ==================-->
</tr>
</tbody>
</table>
-<!--================= end Main ==================-->
-<!--================= start Footer ==================-->
<div id="footer">
<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
<tbody>
<tr>
-<!--================= start Copyright ==================-->
<td colspan="2">
<div align="center">
<div class="copyright">
- Copyright © 2000-2004 The Apache Software Foundation. All rights reserved.
+ Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
</div>
</div>
</td>
-<!--================= end Copyright ==================-->
</tr>
<tr>
-<td align="left">
-<!--================= start Host ==================-->
-<!--================= end Host ==================--></td><td align="right">
-<!--================= start Credits ==================-->
+<td align="left"></td><td align="right">
<div align="right">
<div class="credit"></div>
</div>
-<!--================= end Credits ==================-->
</td>
</tr>
</tbody>
</table>
</div>
-<!--================= end Footer ==================-->
</body>
</html>
Modified: webservices/axis/trunk/c/docs/arch/handler.pdf
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/arch/handler.pdf?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
Binary files - no diff available.
Modified: webservices/axis/trunk/c/docs/arch/mem-management.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/arch/mem-management.html?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
--- webservices/axis/trunk/c/docs/arch/mem-management.html (original)
+++ webservices/axis/trunk/c/docs/arch/mem-management.html Mon Dec 19 07:43:10 2005
@@ -2,7 +2,6 @@
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<!--*** This is a generated file. Do not edit. ***-->
<link rel="stylesheet" href="../../skin/tigris.css" type="text/css">
<link rel="stylesheet" href="../../skin/mysite.css" type="text/css">
<link rel="stylesheet" href="../../skin/site.css" type="text/css">
@@ -10,25 +9,19 @@
<title>Axis C++ Memory Management Guide</title>
</head>
<body bgcolor="white" class="composite">
-<!--================= start Banner ==================-->
<div id="banner">
<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
<tbody>
<tr>
-<!--================= start Group Logo ==================-->
<td align="left">
<div class="groupLogo">
<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../../images/project-logo.jpg"></a>
</div>
-</td>
-<!--================= end Group Logo ==================-->
-<!--================= start Project Logo ==================--><td align="right">
+</td><td align="right">
<div class="projectLogo">
<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../../images/axis.jpg"></a>
</div>
-</td>
-<!--================= end Project Logo ==================-->
-<!--================= start Search ==================--><td valign="top" rowspan="2" align="right" class="search">
+</td><td valign="top" rowspan="2" align="right" class="search">
<form target="_blank" action="http://www.google.com/search" method="get">
<table summary="search" border="0" cellspacing="0" cellpadding="0">
<tr>
@@ -51,34 +44,24 @@
</table>
</form>
</td>
-<!--================= end Search ==================-->
</tr>
</tbody>
</table>
</div>
-<!--================= end Banner ==================-->
-<!--================= start Main ==================-->
<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
<tbody>
-<!--================= start Status ==================-->
<tr class="status">
-<td>
-<!--================= start BreadCrumb ==================--><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a>
-<!--================= end BreadCrumb ==================--></td><td id="tabs">
-<!--================= start Tabs ==================-->
+<td><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a></td><td id="tabs">
<div class="tab">
<span class="selectedTab"><a class="base-selected" href="../../index.html">WebServices-Axis</a></span>
</div>
-<!--================= end Tabs ==================-->
</td>
</tr>
</tbody>
</table>
-<!--================= end Status ==================-->
<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
<tbody>
<tr valign="top">
-<!--================= start Menu ==================-->
<td id="leftcol">
<div id="navcolumn">
<div class="menuBar">
@@ -86,13 +69,12 @@
<span class="menuLabel">Axis</span>
<div class="menuItem">
-<a href="../../index.html">Introduction</a>
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
</div>
<div class="menuItem">
-<a href="../../news.html">News</a>
+<a href="http://ws.apache.org/axis/news.html">News</a>
</div>
-
<div class="menuItem">
<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
@@ -102,27 +84,27 @@
<span class="menuLabel">Get Involved</span>
<div class="menuItem">
-<a href="../../overview.html">Overview</a>
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
</div>
<div class="menuItem">
-<a href="../../cvs.html">CVS Repository</a>
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
</div>
<div class="menuItem">
-<a href="../../mail.html">Mailing Lists</a>
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
</div>
<div class="menuItem">
-<a href="../../ref.html">Reference Library</a>
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
</div>
<div class="menuItem">
-<a href="../../bugs.html">Bugs</a>
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
</div>
<div class="menuItem">
-<a href="../../howtobuild.html">HowToBuildSite</a>
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
</div>
</div>
@@ -131,39 +113,39 @@
<span class="menuLabel">Axis (Java)</span>
<div class="menuItem">
-<a href="../../java/index.html">Documentation</a>
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
</div>
<div class="menuItem">
-<a href="../../java/install.html">Installation</a>
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
</div>
<div class="menuItem">
-<a href="../../java/user-guide.html">User's Guide</a>
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/developers-guide.html">Developer's Guide</a>
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/integration-guide.html">Integration Guide</a>
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/architecture-guide.html">Architecture Guide</a>
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/reference.html">Reference Guide</a>
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/reading.html">Reading Guide</a>
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
</div>
<div class="menuItem">
-<a href="../../java/requirements.html">Requirements</a>
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
</div>
</div>
@@ -172,7 +154,7 @@
<span class="menuLabel">Axis (C++)</span>
<div class="menuItem">
-<a href="../../cpp/index.html">Latest Axis C++ Release!</a>
+<a href="../../cpp/index.html">Home</a>
</div>
<div class="menuItem">
@@ -197,11 +179,11 @@
<span class="menuLabel">Downloads</span>
<div class="menuItem">
-<a href="../../releases.html">Releases</a>
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
</div>
<div class="menuItem">
-<a href="../../interim.html">Interim Drops</a>
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
</div>
<div class="menuItem">
@@ -214,7 +196,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
</div>
</div>
@@ -244,23 +226,19 @@
<span class="menuLabel">Misc</span>
<div class="menuItem">
-<a href="../../site.html">Whole Site</a>
-</div>
-
-<div class="menuItem">
-<a href="../../who.html">Who We Are</a>
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
</div>
<div class="menuItem">
-<a href="../../contact.html">Contact</a>
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
</div>
<div class="menuItem">
-<a href="../../legal.html">Legal</a>
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
</div>
<div class="menuItem">
-<a href="../../docs.html">Notes/Docs</a>
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
</div>
</div>
@@ -269,9 +247,7 @@
</div>
</div>
</div>
-</td>
-<!--================= end Menu ==================-->
-<!--================= start Content ==================--><td>
+</td><td>
<div id="bodycol">
<div class="app">
<div align="center">
@@ -369,7 +345,6 @@
<div class="h4">
<h4>Open Issues</h4>
</div>
-<p>As C++ is an object oriented language, one would ideally like to leverage constructors and destructors for memory management. However, the Axis C++ engine uses structs in some cases (e.g. Arrays) and uses <em>malloc()</em> to allocate memory. Hence the C++ programmer would be forced to use <em>free()</em> at times. When using <em>malloc()</em> and <em>free()</em> constructors and destructors are not called. However, as the Axis C++ engine currently supports both C and C++, it is not simple to replace all <em>malloc()</em> with <em>new</em> or <em>free()</em> with <em>delete</em>. At the same time, there are some places where <em>new</em> and <em>delete</em> are being used. They too cannot be replaced with <em>malloc()</em> and <em>free()</em> overnight. This memory management complexity is the price paid for dual support of C and C++. Efforts are under way to clean up the memory management mix-ups and still support both C and C++. Currently the proposed solution is to mak
e the Axis C++ engine pure C++ and use a wrapper mechanism to support C.</p>
<p>When an array is de-serialized it uses C style memory re-allocation mechanism in the present code. C++ does not support <em>realloc()</em> and if we use <em>new</em> instead we have to allocate fresh memory blocks each time we need to increase the array size. This can be more expensive than using <em>realloc()</em>. Again the price paid for efficiency is that one has to use <em>free()</em> and not <em>delete []</em> from C++ code.</p>
<div id="pdf" align="right">
<a href="mem-management.pdf"><img alt="PDF" src="../../skin/images/pdfdoc.gif" class="skin"><br>
@@ -379,40 +354,30 @@
</div>
</div>
</td>
-<!--================= end Content ==================-->
</tr>
</tbody>
</table>
-<!--================= end Main ==================-->
-<!--================= start Footer ==================-->
<div id="footer">
<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
<tbody>
<tr>
-<!--================= start Copyright ==================-->
<td colspan="2">
<div align="center">
<div class="copyright">
- Copyright © 2000-2004 The Apache Software Foundation. All rights reserved.
+ Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
</div>
</div>
</td>
-<!--================= end Copyright ==================-->
</tr>
<tr>
-<td align="left">
-<!--================= start Host ==================-->
-<!--================= end Host ==================--></td><td align="right">
-<!--================= start Credits ==================-->
+<td align="left"></td><td align="right">
<div align="right">
<div class="credit"></div>
</div>
-<!--================= end Credits ==================-->
</td>
</tr>
</tbody>
</table>
</div>
-<!--================= end Footer ==================-->
</body>
</html>
Modified: webservices/axis/trunk/c/docs/index.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/index.html?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
--- webservices/axis/trunk/c/docs/index.html (original)
+++ webservices/axis/trunk/c/docs/index.html Mon Dec 19 07:43:10 2005
@@ -1,10 +1,399 @@
-<!doctype html public "-//w3c//dtd html 4.0 transitional//en"><html><head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <meta name="GENERATOR" content="Microsoft FrontPage 4.0"> <title>Axis Documentation</title> <link href="axis.css" rel=stylesheet type=text/css></head><body><center><h1><img SRC="images/axis.jpg" height=96 width=176></h1></center><h1>Documentation</h1>This is the documentation for <a href="index/index.html">Apache Axis C++ 1.4 Alpha</a> <h2>Installation Guides</h2><ul><li><a href="lininstall-guide.html">Linux Installation Instructions</a></li><li><a href="wininstall-guide.html">Windows Installation Instructions</a></li></ul><h2>User Guides</h2><ul><li><a href="linuser-guide.html">Linux User Guide</a></li><li><a href="winuser-guide.html">Windows User Guide</a></li></ul><h2>Developer Guides</h2><ul><li><a href="windev-guide.html">Windows Developer's Guide</a></li>
-<LI><A href="antbuild-guide.html">ANT Build Guide</A></LI></ul><h2>Reference Material</h2><li><a href="arch/handler.html">Handler Tutorial</a></li> <li><a href="arch/ArchitectureGuide.html">Architecture Guide</a></li><li><a href="arch/WSDL2Ws.html">WSDL2Ws Tool</a></li><li><a href="arch/mem-management.html">Memory Management Guide</a></li>
-<LI><A href="arch/XSD_Objects.html">XSD Objects</A></LI>
-</ul></body></html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<link rel="stylesheet" href="../skin/tigris.css" type="text/css">
+<link rel="stylesheet" href="../skin/mysite.css" type="text/css">
+<link rel="stylesheet" href="../skin/site.css" type="text/css">
+<link media="print" rel="stylesheet" href="../skin/print.css" type="text/css">
+<title>Axis C++</title>
+</head>
+<body bgcolor="white" class="composite">
+<div id="banner">
+<table width="100%" cellpadding="8" cellspacing="0" summary="banner" border="0">
+<tbody>
+<tr>
+<td align="left">
+<div class="groupLogo">
+<a href="http://ws.apache.org/"><img border="0" class="logoImage" alt="The Apache WebServices Project" src="../images/project-logo.jpg"></a>
+</div>
+</td><td align="right">
+<div class="projectLogo">
+<a href="http://ws.apache.org/axis/"><img border="0" class="logoImage" alt="The Apache Axis Project" src="../images/axis.jpg"></a>
+</div>
+</td><td valign="top" rowspan="2" align="right" class="search">
+<form target="_blank" action="http://www.google.com/search" method="get">
+<table summary="search" border="0" cellspacing="0" cellpadding="0">
+<tr>
+<td bgcolor="#a5b6c6" colspan="3"><img height="10" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="8" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td nowrap="nowrap"><input value="ws.apache.org" name="sitesearch" type="hidden"><input size="10" name="q" id="query" type="text"><img height="1" width="5" alt="" src="../skin/images/spacer.gif" class="spacer"><input name="Search" value="GO" type="submit">
+<br>
+ Search WS</td><td><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td colspan="3"><img height="7" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td>
+</tr>
+<tr>
+<td class="bottom-left-thick"></td><td bgcolor="#a5b6c6"><img height="1" width="1" alt="" src="../skin/images/spacer.gif" class="spacer"></td><td class="bottom-right-thick"></td>
+</tr>
+</table>
+</form>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<table width="100%" cellpadding="0" cellspacing="0" border="0" summary="nav" id="breadcrumbs">
+<tbody>
+<tr class="status">
+<td><a href="http://www.apache.org/">Apache</a> | <a href="http://ws.apache.org/">WS</a><a href=""></a></td><td id="tabs">
+<div class="tab">
+<span class="selectedTab"><a class="base-selected" href="../index.html">WebServices-Axis</a></span>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+<table id="main" width="100%" cellpadding="8" cellspacing="0" summary="" border="0">
+<tbody>
+<tr valign="top">
+<td id="leftcol">
+<div id="navcolumn">
+<div class="menuBar">
+<div class="menu">
+<span class="menuLabel">Axis</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/news.html">News</a>
+</div>
+
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
+</div>
+
+<div class="menu">
+<span class="menuLabel">Get Involved</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Axis (Java)</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
+</div>
+
+</div>
+
+<div class="menu">
+<span class="menuLabel">Axis (C++)</span>
+
+<div class="menuItem">
+<span class="menuSelected">Home</span>
+</div>
+
+<div class="menuItem">
+<a href="../cpp/documentation.html">Documentation</a>
+</div>
+
+<div class="menuItem">
+<a href="../cpp/download.html">Download</a>
+</div>
+
+<div class="menuItem">
+<a href="http://wiki.apache.org/ws/FrontPage/AxisCPP">Wiki Pages</a>
+</div>
+
+<div class="menuItem">
+<a href="../cpp/who.html">Who we are</a>
+</div>
+
+</div>
+<div class="menu">
+<span class="menuLabel">Downloads</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
+</div>
+
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/ws-axis/">Source Code</a>
+</div>
+</div>
+<div class="menu">
+<span class="menuLabel">Translation</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
+</div>
+</div>
+<div class="menu">
+<span class="menuLabel">Related Projects</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/wsif/">WSIF</a>
+</div>
+
+<div class="menuItem">
+<a href="http://cvs.apache.org/viewcvs/*checkout*/ws-wsil/java/README.htm">WSIL</a>
+</div>
+
+<div class="menuItem">
+<a href="http://www-124.ibm.com/developerworks/projects/wsdl4j/">WSDL4J</a>
+</div>
+
+<div class="menuItem">
+<a href="http://www.uddi4j.org/">UDDI4J</a>
+</div>
+</div>
+
+<div class="menu">
+<span class="menuLabel">Misc</span>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
+</div>
+
+<div class="menuItem">
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
+</div>
+
+</div>
+
+
+</div>
+</div>
+</div>
+</td><td>
+<div id="bodycol">
+<div class="app">
+<div align="center">
+<h1>Axis C++</h1>
+</div>
+<div class="h3">
+<div class="h3">
+<h3>Welcome to Axis CPP</h3>
+</div>
+<p>Axis C/C++ (Axis CPP) is a non-Java implementation of Axis. At its core Axis CPP has a C++ runtime engine. The provided tooling allows you to create C++ client-side stubs and server-side skeletons. The server skeletons can be deployed to either a full Apache web server using the supplied apache module or a "simple_axis_server" - which is a simple HTTP listener (designed to help you test your services).<br>
+<br>There is also limited support for C wrappers around the generated Server and client objects. However, at the current time it is not recommended that these be used in a production environment.</p>
+<p>The implementation has concentrated on being ws-i profile compliant. The implementation does not have support for ws-* specifications and it is envisaged that this will be provided by Axis2. However, at the current time, Axis CPP is still being actively developed and improved until such times as Axis2 C implementation has progressed far enough to take over its role.</p>
+<div class="h4">
+<h4>Contents</h4>
+</div>
+<ul>
+<li>
+<a href="#Features">Features</a>
+</li>
+<li>
+<a href="#QualityAssurance">Quality Assurance</a>
+</li>
+<li>
+<a href="#Schedules">Schedules</a>
+</li>
+<li>
+<a href="#LatestRelease">Axis C++ 1.5 release</a>
+</li>
+<li style="list-style: none">
+<ul>
+<li>
+<a href="#Key Features">Key Features</a>
+</li>
+<li>
+<a href="#BugFixList">Fix List</a>
+</li>
+<li>
+<a href="#Known issues">Known issues</a>
+</li>
+</ul>
+</li>
+</ul>
+<p>
+<a name="Features"></a>
+</p>
+<div class="h4">
+<h4>Features</h4>
+</div>
+<ul>
+<li>Soap engine with both client and server support</li>
+<li>WSDD based deployment with dynamic deployment tools.</li>
+<li>Support for all basic types, Complex types and Arrays</li>
+<li>WSDL2WS tool for building C/C++ components</li>
+<li>Server side - Skeletons and Wrappers</li>
+<li>Client side - Stubs</li>
+<li>Standalone server (with HTTP support)</li>
+<li>Web server modules for Apache 1.3 & Apache2 (Linux/Windows)</li>
+<li>Web interface to the deployed services and their WSDL s.</li>
+<li>Sample web services and client applications.</li>
+</ul>
+<div class="h4">
+<h4>Quality Assurance</h4>
+</div>
+<p>
+<a name="QualityAssurance"></a>In the past year and a half, the comprehensive test-suite has been created and maintained to a high-level. The suite is run over all the nightly builds. If bugs are found then tests are added to ensure that the code does not regress - this is your assurance of quality.</p>
+<div class="h4">
+<h4>Schedules</h4>
+</div>
+<p>
+<a name="Schedules"></a> At any time you can get a copy of the latest <a href="http://cvs.apache.org/dist/axis/nightly/">overnight build</a> and we try to produce a full release at least every 6 months.</p>
+<p>The current level of Axis CPP that we recommend is 1.5.</p>
+<p>At the moment we envisage 1.6 being released in late December. This will have many bug fixes in it for the more complex scenarios that we see Axis CPP being used in over recent months.</p>
+<p>
+<a name="LatestRelease"></a>Axis C++ 1.5 Final</p>
+<p>
+<a href="download.html">Download the latest release of Axis C++</a>
+</p>
+<p>
+<a name="Key_Features"></a>Key features of Axis C++ 1.5</p>
+<ul>
+<li>
+<strong>New client side transport</strong>
+<br> This is called Axis3 transport.This is a cleaner, more extensible and vastily more reliable transport compared to previous versions. It has better support for proxies, cookies and more.</li>
+<li>WSDL tool fixes to handle nillable types.</li>
+<li>Supports Broader XSD types.</li>
+<li>Supports Broader XSD Any types</li>
+</ul>
+<p>
+<a name="BugFixList"></a>The Bug Fixes</p>
+<p>AXISCPP-605<br> AXISCPP-602<br>AXISCPP-600<br>AXISCPP-596<br>AXISCPP-594<br>AXISCPP-593<br>AXISCPP-592<br>AXISCPP-591<br>AXISCPP-590<br>AXISCPP-589<br>AXISCPP-587<br>AXISCPP-586<br>AXISCPP-585<br>AXISCPP-584<br>AXISCPP-583<br>AXISCPP-582<br>AXISCPP-581<br>AXISCPP-579<br>AXISCPP-576<br>AXISCPP-575<br>AXISCPP-569<br>AXISCPP-568<br>AXISCPP-567<br>AXISCPP-566<br>AXISCPP-564<br>AXISCPP-562<br>AXISCPP-561<br>AXISCPP-560<br>AXISCPP-556<br>AXISCPP-555<br>AXISCPP-553<br>AXISCPP-550<br>AXISCPP-549<br>AXISCPP-545<br>AXISCPP-534<br>AXISCPP-532<br>AXISCPP-531<br>AXISCPP-530<br>AXISCPP-528<br>AXISCPP-525<br>AXISCPP-524<br>AXISCPP-523<br>AXISCPP-521<br>AXISCPP-520<br>AXISCPP-518<br>AXISCPP-517<br>AXISCPP-516<br>AXISCPP-514<br>AXISCPP-513<br>AXISCPP-511<br>AXISCPP-510<br>AXISCPP-509<br>AXISCPP-508<br>AXISCPP-507<br>AXISCPP-504<br>AXISCPP-503<br>AXISCPP-502<br>AXISCPP-501<br>AXISCPP-500<br>AXISCPP-499<br>AXISCPP-498<br>AXISCPP-497<br>AXISCPP-496<br>AXISCPP-495<br>AXISCPP-494<br>AXISCPP-49
3<br>AXISCPP-492<br>AXISCPP-491<br>AXISCPP-490<br>AXISCPP-489<br>AXISCPP-488<br>AXISCPP-487<br>AXISCPP-486<br>AXISCPP-485<br>AXISCPP-484<br>AXISCPP-483<br>AXISCPP-482<br>AXISCPP-481<br>AXISCPP-480<br>AXISCPP-479<br>AXISCPP-478<br>AXISCPP-477<br>AXISCPP-475<br>AXISCPP-474<br>AXISCPP-472<br>AXISCPP-470<br>AXISCPP-469<br>AXISCPP-468<br>AXISCPP-466<br>AXISCPP-465<br>AXISCPP-464<br>AXISCPP-463<br>AXISCPP-462<br>AXISCPP-459<br>AXISCPP-457<br>AXISCPP-456<br>AXISCPP-454<br>AXISCPP-453<br>AXISCPP-451<br>AXISCPP-450<br>AXISCPP-447<br>AXISCPP-446<br>AXISCPP-444<br>AXISCPP-443<br>AXISCPP-442<br>AXISCPP-441<br>AXISCPP-437<br>AXISCPP-436<br>AXISCPP-433<br>AXISCPP-431<br>AXISCPP-430<br>AXISCPP-428<br>AXISCPP-425<br>AXISCPP-420<br>AXISCPP-419<br>AXISCPP-418<br>AXISCPP-417<br>AXISCPP-415<br>AXISCPP-414<br>AXISCPP-413<br>AXISCPP-410<br>AXISCPP-409<br>AXISCPP-408<br>AXISCPP-407<br>AXISCPP-403<br>AXISCPP-400<br>AXISCPP-398<br>AXISCPP-392<br>AXISCPP-390<br>AXISCPP-389<br>AXISCPP-385<br>AXISCPP-3
83<br>AXISCPP-376<br>AXISCPP-375<br>AXISCPP-371<br>AXISCPP-364<br>AXISCPP-355<br>AXISCPP-348<br>AXISCPP-346<br>AXISCPP-344<br>AXISCPP-341<br>AXISCPP-340<br>AXISCPP-335<br>AXISCPP-331<br>AXISCPP-310<br>AXISCPP-306<br>AXISCPP-305<br>AXISCPP-303<br>AXISCPP-300<br>AXISCPP-293<br>AXISCPP-288<br>AXISCPP-270<br>AXISCPP-268<br>AXISCPP-242<br>AXISCPP-216<br>AXISCPP-207<br>AXISCPP-164<br>
+</p>
+<div class="h4">
+<h4>Known Issues</h4>
+</div>
+<p>
+<a name="Known_issues"></a>
+</p>
+<ul>
+<li>C support is not complete.</li>
+<li>There are no vc projects for samples</li>
+</ul>
+<br>
+<br>
+<br>
+<br>
+<br>
+<br>
+<p>
+<br>Please report any bugs in <a href="http://issues.apache.org/jira/secure/Dashboard.jspa">Jira</a> and feel free to let us know your thoughts and/or problems in <a href="mailto:axis-c-user@ws.apache.org">axis-c-user@ws.apache.org</a>
+<br>
+<br>We welcome contributions to Axis C++ so please join the discussions in <a href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a>
+</p>
+<div id="pdf" align="right">
+<a href="index.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+</div>
+</div>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+<div id="footer">
+<table summary="footer" cellspacing="0" cellpadding="4" width="100%" border="0">
+<tbody>
+<tr>
+<td colspan="2">
+<div align="center">
+<div class="copyright">
+ Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
+ </div>
+</div>
+</td>
+</tr>
+<tr>
+<td align="left"></td><td align="right">
+<div align="right">
+<div class="credit">
+<a href="http://validator.w3.org/check/referer"><img width="88" height="31" alt="Valid HTML 4.01!" src="../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/"><img width="88" height="31" alt="Valid CSS!" src="../skin/images/vcss.png" class="logoImage"></a><a href="http://xml.apache.org/forrest/"><img border="0" class="logoImage" alt="Built with Apache Forrest" src="../images/built-with-forrest-button.png" width="88" height="31"></a>
+</div>
+</div>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+</body>
+</html>
Modified: webservices/axis/trunk/c/docs/lininstall-guide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/lininstall-guide.html?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
--- webservices/axis/trunk/c/docs/lininstall-guide.html (original)
+++ webservices/axis/trunk/c/docs/lininstall-guide.html Mon Dec 19 07:43:10 2005
@@ -86,13 +86,12 @@
<span class="menuLabel">Axis</span>
<div class="menuItem">
-<a href="../index.html">Introduction</a>
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
</div>
<div class="menuItem">
-<a href="../news.html">News</a>
+<a href="http://ws.apache.org/axis/news.html">News</a>
</div>
-
<div class="menuItem">
<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
@@ -102,27 +101,27 @@
<span class="menuLabel">Get Involved</span>
<div class="menuItem">
-<a href="../overview.html">Overview</a>
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
</div>
<div class="menuItem">
-<a href="../cvs.html">CVS Repository</a>
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
</div>
<div class="menuItem">
-<a href="../mail.html">Mailing Lists</a>
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
</div>
<div class="menuItem">
-<a href="../ref.html">Reference Library</a>
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
</div>
<div class="menuItem">
-<a href="../bugs.html">Bugs</a>
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
</div>
<div class="menuItem">
-<a href="../howtobuild.html">HowToBuildSite</a>
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
</div>
</div>
@@ -131,39 +130,39 @@
<span class="menuLabel">Axis (Java)</span>
<div class="menuItem">
-<a href="../java/index.html">Documentation</a>
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
</div>
<div class="menuItem">
-<a href="../java/install.html">Installation</a>
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
</div>
<div class="menuItem">
-<a href="../java/user-guide.html">User's Guide</a>
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
</div>
<div class="menuItem">
-<a href="../java/developers-guide.html">Developer's Guide</a>
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
</div>
<div class="menuItem">
-<a href="../java/integration-guide.html">Integration Guide</a>
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
</div>
<div class="menuItem">
-<a href="../java/architecture-guide.html">Architecture Guide</a>
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
</div>
<div class="menuItem">
-<a href="../java/reference.html">Reference Guide</a>
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
</div>
<div class="menuItem">
-<a href="../java/reading.html">Reading Guide</a>
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
</div>
<div class="menuItem">
-<a href="../java/requirements.html">Requirements</a>
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
</div>
</div>
@@ -197,11 +196,11 @@
<span class="menuLabel">Downloads</span>
<div class="menuItem">
-<a href="../releases.html">Releases</a>
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
</div>
<div class="menuItem">
-<a href="../interim.html">Interim Drops</a>
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
</div>
<div class="menuItem">
@@ -214,7 +213,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
</div>
</div>
@@ -244,23 +243,19 @@
<span class="menuLabel">Misc</span>
<div class="menuItem">
-<a href="../site.html">Whole Site</a>
-</div>
-
-<div class="menuItem">
-<a href="../who.html">Who We Are</a>
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
</div>
<div class="menuItem">
-<a href="../contact.html">Contact</a>
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
</div>
<div class="menuItem">
-<a href="../legal.html">Legal</a>
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
</div>
<div class="menuItem">
-<a href="../docs.html">Notes/Docs</a>
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
</div>
</div>
@@ -363,10 +358,7 @@
</div>
<p>
<strong>Note:</strong> The following steps are for Axis C++ source downloads.<br>
-<br>
-Currently Ant build system is used to build Axis C++ source code.
-
-<a href="antbuild-guide.html">ANT Build Guide</a> explains how you can use Ant to build Axis C++.<br>
+<br> Currently Ant build system is used to build Axis C++ source code. <a href="antbuild-guide.html">ANT Build Guide</a> explains how you can use Ant to build Axis C++.<br> <br>
</p>
<p>
<strong>Note:</strong> The following steps are common to both source and binary downloads.<br>
@@ -473,7 +465,6 @@
<strong>./base http://localhost:9090/axis/base</strong>
</p>
<p>Similarly you could run the other samples.</p>
-<p>Similarly you could run the other samples.</p>
<a href="lininstall-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"><br> PDF</a>
<br>
<br>
@@ -499,7 +490,7 @@
<td colspan="2">
<div align="center">
<div class="copyright">
- Copyright © 2000-2004 The Apache Software Foundation. All rights reserved.
+ Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
</div>
</div>
</td>
Modified: webservices/axis/trunk/c/docs/linuser-guide.html
URL: http://svn.apache.org/viewcvs/webservices/axis/trunk/c/docs/linuser-guide.html?rev=357711&r1=357710&r2=357711&view=diff
==============================================================================
--- webservices/axis/trunk/c/docs/linuser-guide.html (original)
+++ webservices/axis/trunk/c/docs/linuser-guide.html Mon Dec 19 07:43:10 2005
@@ -86,13 +86,12 @@
<span class="menuLabel">Axis</span>
<div class="menuItem">
-<a href="../index.html">Introduction</a>
+<a href="http://ws.apache.org/axis/index.html">Introduction</a>
</div>
<div class="menuItem">
-<a href="../news.html">News</a>
+<a href="http://ws.apache.org/axis/news.html">News</a>
</div>
-
<div class="menuItem">
<a href="http://wiki.apache.org/ws/FrontPage/Axis">FAQ/Wiki</a>
@@ -102,27 +101,27 @@
<span class="menuLabel">Get Involved</span>
<div class="menuItem">
-<a href="../overview.html">Overview</a>
+<a href="http://ws.apache.org/axis/overview.html">Overview</a>
</div>
<div class="menuItem">
-<a href="../cvs.html">CVS Repository</a>
+<a href="http://ws.apache.org/axis/cvs.html">CVS Repository</a>
</div>
<div class="menuItem">
-<a href="../mail.html">Mailing Lists</a>
+<a href="http://ws.apache.org/axis/mail.html">Mailing Lists</a>
</div>
<div class="menuItem">
-<a href="../ref.html">Reference Library</a>
+<a href="http://ws.apache.org/axis/ref.html">Reference Library</a>
</div>
<div class="menuItem">
-<a href="../bugs.html">Bugs</a>
+<a href="http://ws.apache.org/axis/bugs.html">Bugs</a>
</div>
<div class="menuItem">
-<a href="../howtobuild.html">HowToBuildSite</a>
+<a href="http://ws.apache.org/axis/howtobuild.html">HowToBuildSite</a>
</div>
</div>
@@ -131,39 +130,39 @@
<span class="menuLabel">Axis (Java)</span>
<div class="menuItem">
-<a href="../java/index.html">Documentation</a>
+<a href="http://ws.apache.org/axis/java/index.html">Documentation</a>
</div>
<div class="menuItem">
-<a href="../java/install.html">Installation</a>
+<a href="http://ws.apache.org/axis/java/install.html">Installation</a>
</div>
<div class="menuItem">
-<a href="../java/user-guide.html">User's Guide</a>
+<a href="http://ws.apache.org/axis/java/user-guide.html">User's Guide</a>
</div>
<div class="menuItem">
-<a href="../java/developers-guide.html">Developer's Guide</a>
+<a href="http://ws.apache.org/axis/java/developers-guide.html">Developer's Guide</a>
</div>
<div class="menuItem">
-<a href="../java/integration-guide.html">Integration Guide</a>
+<a href="http://ws.apache.org/axis/java/integration-guide.html">Integration Guide</a>
</div>
<div class="menuItem">
-<a href="../java/architecture-guide.html">Architecture Guide</a>
+<a href="http://ws.apache.org/axis/java/architecture-guide.html">Architecture Guide</a>
</div>
<div class="menuItem">
-<a href="../java/reference.html">Reference Guide</a>
+<a href="http://ws.apache.org/axis/java/reference.html">Reference Guide</a>
</div>
<div class="menuItem">
-<a href="../java/reading.html">Reading Guide</a>
+<a href="http://ws.apache.org/axis/java/reading.html">Reading Guide</a>
</div>
<div class="menuItem">
-<a href="../java/requirements.html">Requirements</a>
+<a href="http://ws.apache.org/axis/java/requirements.html">Requirements</a>
</div>
</div>
@@ -197,11 +196,11 @@
<span class="menuLabel">Downloads</span>
<div class="menuItem">
-<a href="../releases.html">Releases</a>
+<a href="http://ws.apache.org/axis/releases.html">Releases</a>
</div>
<div class="menuItem">
-<a href="../interim.html">Interim Drops</a>
+<a href="http://ws.apache.org/axis/interim.html">Interim Drops</a>
</div>
<div class="menuItem">
@@ -214,7 +213,7 @@
<span class="menuLabel">Translation</span>
<div class="menuItem">
-<a href="http://ws.apache.org/axis/jp/">Japanese</a>
+<a href="http://ws.apache.org/axis/ja/index.html">Japanese</a>
</div>
</div>
@@ -244,23 +243,19 @@
<span class="menuLabel">Misc</span>
<div class="menuItem">
-<a href="../site.html">Whole Site</a>
+<a href="http://ws.apache.org/axis/who.html">Who We Are</a>
</div>
<div class="menuItem">
-<a href="../who.html">Who We Are</a>
+<a href="http://ws.apache.org/axis/contact.html">Contact</a>
</div>
<div class="menuItem">
-<a href="../contact.html">Contact</a>
+<a href="http://ws.apache.org/axis/legal.html">Legal</a>
</div>
<div class="menuItem">
-<a href="../legal.html">Legal</a>
-</div>
-
-<div class="menuItem">
-<a href="../docs.html">Notes/Docs</a>
+<a href="http://ws.apache.org/axis/docs.html">Notes/Docs</a>
</div>
</div>
@@ -284,8 +279,7 @@
<h3>Contents</h3>
<dl>
<dt>
-<br>
-<a href="#Introducti">Introduction </a>
+<br>THIS IS A REALLY GREAT LINUX USER GUIDE !<a href="#Introducti">Introduction </a>
</dt>
<dt>
<a href="#What">What's in this release</a>
@@ -391,7 +385,7 @@
<p>- Method invocation</p>
<p>- WSDLs hosted statistically in the server.</p>
<p>- Standalone server (with HTTP support)</p>
-<p>- Web server modules for Apache 1.3 &amp; Apache2 (Linux/Windows)</p>
+<p>- Web server modules for Apache 1.3 &amp;amp; Apache2 (Linux/Windows)</p>
<p>- Basic Wrapper Class Generator tool.</p>
<p>- Web interface to the deployed services and their WSDL s.</p>
<p>- Sample web services and client applications.</p>
@@ -523,40 +517,31 @@
<a name="Deploying"></a>
</p>
<h3>Building and Deploying the Service</h3>
- <p>To build the service library</p>
- <p><strong>g++ -shared -I$AXISCPP_HOME/include -olibmyservice.so
- *.cpp </strong></p>
- <p>libmyservice.so is the name you give to your service library.
- You can give any name you wish. But remeber to prefix with lib
- and suffix with .so</p>
- <p>Copy this service library into $AXICPP_DEPLOY/lib</p>
- <p>Modify the <strong>$AXIS_HOME/conf/server.wsdd</strong> . (You
- have a sample server.wsdd file entry given below appropriately
- filled for this service).</p>
- <p><strong><?xml version="1.0" encoding="UTF-8"?>
- <br>
- <deployment xmlns="http://xml.apache.org/axis/wsdd/"xmlns:C="http://xml.apache.org/axis/wsdd/providers/c">
- <br>
- <service> <br>
- <service name ="Calculator" provider ="CPP:RPC"
- description:"Simple calculator web service"> <parameter
- name="classname" value = "/usr/local/Axis/webservices/libcalculator.so"
- /> </strong></p>
- <p><strong><parameter name= "allowedMethods" value="add
- sub mul div "/> </service> </strong></p>
- <p><strong><br>
- </deployment> </strong></p>
- <p>The deployment descripter is autogenarated by wsdl2ws tool as
- deploy.wsdd in the folder in which the server codes are autogenerated.
- You can just copy and paste the contents of this file to [Apache_Folder]/Axis/conf/server.wsdd.</p>
- <p>Note: <strong>"allowedMethods"</strong> parameter is
- <strong>optional</strong>. Server will be working fine without
- this line in the descripter.</p>
- <p>Now you have deployed your web service</p>
- <p> </p>
- <p>Start the Apache server<br>
- </p>
- <p>
+<p>To build the service library</p>
+<p>
+<strong>g++ -shared -I$AXISCPP_HOME/include -olibmyservice.so *.cpp</strong>
+</p>
+<p>libmyservice.so is the name you give to your service library. You can give any name you wish. But remeber to prefix with lib and suffix with .so</p>
+<p>Copy this service library into $AXICPP_DEPLOY/lib</p>
+<p>Modify the <strong>$AXIS_HOME/conf/</strong><strong>server.wsdd</strong> . (You have a sample server.wsdd file entry given below appropriately filled for this service).</p>
+<p>
+<strong><?xml version="1.0" encoding="UTF-8"?></strong>
+<br>
+<strong><deployment xmlns="http://xml.apache.org/axis/wsdd/"xmlns:C="http://xml.apache.org/axis/wsdd/providers/c"></strong>
+<br>
+<strong><service></strong>
+<br>
+<strong><service name ="Calculator" provider ="CPP:RPC" description:"Simple calculator web service"> <parameter name="classname" value = "/usr/local/Axis/webservices/libcalculator.so" /></strong>
+</p>
+<p>
+<strong><parameter name= "allowedMethods" value="add sub mul div "/> </service></strong>
+<br>
+</p>
+<p>
+<strong></deployment></strong>
+</p>
+<p>Start the Apache server</p>
+<p>
<strong>$ /usr/local/apache/bin/apachectl start</strong>
</p>
<p>Now open a browser and enter the link http://localhost/axis If the service is correctly deployed then it will be displayed in a table of deployed services which contain information such as service name, link to wsdl and a description of the service.</p>
@@ -878,7 +863,7 @@
<td colspan="2">
<div align="center">
<div class="copyright">
- Copyright © 2000-2004 The Apache Software Foundation. All rights reserved.
+ Copyright © 2000-2005 The Apache Software Foundation. All rights reserved.
</div>
</div>
</td>