roshan 2004/05/31 03:28:26
Modified: targets/axis/cpp winuser-guide.pdf winuser-guide.html
Log:
Added handlers to the winuser guide doc.Changed by Rangika & Sevwandi
Revision Changes Path
1.14 +223 -137 ws-site/targets/axis/cpp/winuser-guide.pdf
<<Binary file>>
1.15 +69 -1 ws-site/targets/axis/cpp/winuser-guide.html
Index: winuser-guide.html
===================================================================
RCS file: /home/cvs/ws-site/targets/axis/cpp/winuser-guide.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- winuser-guide.html 28 May 2004 10:19:01 -0000 1.14
+++ winuser-guide.html 31 May 2004 10:28:26 -0000 1.15
@@ -284,8 +284,10 @@
<a href="#client">Coding the client</a>
<br>
<a href="#sample">Running your sample</a>
+<br>
+<a href="#handlers">Handlers</a>
<br>
-<br>
+<br>
<strong>Before you follow this guide, make sure that you have followed the</strong>
<a href="wininstall-guide.html"><strong>Windows Installation guide</strong></a>
</p>
<p>
@@ -373,8 +375,74 @@
<a name="caluculatorsample"></a>
</p>
<br>
+<p>SUCCESS ! If you get the result, you are done.</p>
+<p>
+<a name="handlers"></a>
+</p>
+<div class="h4">
+<h4>Handlers</h4>
+</div>
+<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.</p>
+<p>
+<strong>Note: If you are using Client side Handlers you need to enter the following
entry in the AXIS_FOLDER/axiscpp.conf configuration file.</strong>
+</p>
+<p>CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<p>After entering this entry to your AXIS_FOLDER/axiscpp.conf configuration file
will look like:</p>
+<p>AXISLOGPATH:Axis\logs\AxisLog.txt<br>WSDDFILEPATH:Axis\conf\server.wsdd<br>CLIENTWSDDFILEPATH:Axis\conf\client.wsdd</p>
+<strong>Testing the sample Handlers</strong>
+<p>We have included the following sample Handlers for your reference.</p>
+<p>1) echoStringHeaderHandler (A server side handler sample) This sample handler
will simply echo (i.e send back) the string which you send in the SOAP
request.<br>2)testHandler (A client side handler sample)</p>
+<p>This sample handler will simply add a SOAP Header to the generated SOAP
request.</p>
+<p>Please note that these are very primitive sample handlers and are presented here
to give you an idea about writing your own Handlers.</p>
+<p>
+<strong>echoStringHeaderHandler</strong>
+</p>
+<p>
+<strong>Building the Sample Handlers in VC</strong>
+</p>
<br>
+<strong>Building echoStringHeaderHandler (A server side handler sample)</strong>
<br>
+<p>The VC dsw file (ServerHandlers.dsw) is available at
AXIS_EXTRACT/vc/samples/server/ ServerHandlers.dsw. Open this file and build the
project echoStringHeaderHandler. Once the build is successful you will find the DLL
(echoStringHeaderHandler.dll) at AXIS_EXTRACT/bin. If you see this DLL at the above
location you are done with the first step.</p>
+<p>
+<strong>Configuring the Handler</strong>
+</p>
+<p>Now edit the AXIS_FOLDER /conf/server.wsdd to include the handler for a
particular service.</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></p>
+<p>
+<strong>Note: Make sure you specify the correct path of the handler dll in the
server.wsdd file.</strong>
+</p>
+<p>Now you are almost done to run your server side handler.<br>Restart the Apache
server and thats it.</p>
+<br>
+<br>
+<strong>Running the Handler</strong>
+<p>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.</p>
+<p>
+<strong>testHandler</strong>
+</p>
+<p>
+<strong>Building the Sample Handlers in VC</strong>
+</p>
+<p>Building testHandler (A client side handler sample)</p>
+<p>The VC dsw file (ServerHandlers.dsw) is available at
AXIS_EXTRACT/vc/samples/client/ClientHandlers.dsw. Open this file and build the
project TestHandler. 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.</p>
+<p>
+<strong>Configuring the Handler</strong>
+</p>
+<p>Now edit the AXIS_FOLDER /conf/client.wsdd to include the handler for a
particular service.</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: Make sure you specify the correct path of the handler dll in the
client.wsdd file.</strong>
+</p>
+<p>Now you are almost done to run your client side handler.</p>
+<p>
+<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>
+</p>
+<p>
+<strong>Running the Handler</strong>
+</p>
+<p>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)</p>
+<p>Handler Notes:</p>
+<p>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
(AXIS_EXTRACT/samples/server/echoStringHeaderHandler)<br>b. testHandler
(AXIS_EXTRACT/samples/client/testHandler)</p>
<div id="pdf" align="right">
<a href="winuser-guide.pdf"><img alt="PDF" src="../skin/images/pdfdoc.gif"
class="skin"><br>
PDF</a>
