Return-Path: Delivered-To: apmail-ws-axis-dev-archive@www.apache.org Received: (qmail 63507 invoked from network); 31 May 2004 10:34:54 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 31 May 2004 10:34:54 -0000 Received: (qmail 63122 invoked by uid 500); 31 May 2004 10:34:53 -0000 Delivered-To: apmail-ws-axis-dev-archive@ws.apache.org Received: (qmail 62873 invoked by uid 500); 31 May 2004 10:34:50 -0000 Mailing-List: contact axis-cvs-help@ws.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Delivered-To: mailing list axis-cvs@ws.apache.org Received: (qmail 62858 invoked by uid 99); 31 May 2004 10:34:50 -0000 Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.27.1) with SMTP; Mon, 31 May 2004 03:34:50 -0700 Received: (qmail 56692 invoked by uid 1686); 31 May 2004 10:27:23 -0000 Date: 31 May 2004 10:27:23 -0000 Message-ID: <20040531102723.56685.qmail@minotaur.apache.org> From: roshan@apache.org To: ws-axis-cvs@apache.org Subject: cvs commit: ws-axis/site/src/documentation/content/xdocs/cpp winuser-guide.ihtml X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N roshan 2004/05/31 03:27:22 Modified: site/src/documentation/content/xdocs/cpp winuser-guide.ihtml Log: Added handlers to the winuser guide source Revision Changes Path 1.12 +93 -2 ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml Index: winuser-guide.ihtml =================================================================== RCS file: /home/cvs/ws-axis/site/src/documentation/content/xdocs/cpp/winuser-guide.ihtml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- winuser-guide.ihtml 28 May 2004 10:16:57 -0000 1.11 +++ winuser-guide.ihtml 31 May 2004 10:27:22 -0000 1.12 @@ -23,7 +23,9 @@
Running your sample
-
+ +Handlers

+ Before you follow this guide, make sure that you have followed the @@ -277,6 +279,95 @@

-SUCCESS ! If you get the result, you are done.

SUCCESS ! If you get the result, you are done.

+ +

Handlers

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.

Note: If you are using Client side Handlers you need to enter the following entry in the AXIS_FOLDER/axiscpp.conf configuration file.

CLIENTWSDDFILEPATH:Axis\conf\client.wsdd

After entering this entry to your AXIS_FOLDER/axiscpp.conf configuration file will look like:

AXISLOGPATH:Axis\logs\AxisLog.txt +
WSDDFILEPATH:Axis\conf\server.wsdd +
CLIENTWSDDFILEPATH:Axis\conf\client.wsdd

+Testing the sample Handlers +

We have included the following sample Handlers for your reference.

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. +
2)testHandler (A client side handler sample)

This sample handler will simply add a SOAP Header to the generated SOAP request.

Please note that these are very primitive sample handlers and are presented here to give you an idea about writing your own Handlers.

echoStringHeaderHandler

Building the Sample Handlers in VC

+
+Building echoStringHeaderHandler (A server side handler sample) +
+

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.

Configuring the Handler

Now edit the AXIS_FOLDER /conf/server.wsdd to include the handler for a particular service.

Note: Make sure you specify the correct path of the handler dll in the server.wsdd file.

Now you are almost done to run your server side handler. +
+Restart the Apache server and thats it.

+
+
+Running the Handler +

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.

testHandler

Building the Sample Handlers in VC

Building testHandler (A client side handler sample)

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.

Configuring the Handler

Now edit the AXIS_FOLDER /conf/client.wsdd to include the handler for a particular service.

Note: Make sure you specify the correct path of the handler dll in the client.wsdd file.

Now you are almost done to run your client side handler.

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)

Running the Handler

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)

Handler Notes:

1) You can see the Handler behavior through the TCP Monitor. (TCP Monitor is a Axis Java tool) +
+2) To get an idea of Handlers look at the Handler sample source files. +
+a. echoStringHeaderHandler (AXIS_EXTRACT/samples/server/echoStringHeaderHandler) +
+b. testHandler +(AXIS_EXTRACT/samples/client/testHandler)