This example of a typical Web Services Deployment Descriptor (WSDD) file demonstrates how to construct a WSDD file.
The first two lines of the following exampleWSDD file , which must remain as they are shown here, tell the WSDD parser how to read the file, and provide vital information for the subsequent sections. After the mandatory header, there are two main sections, one for service handlers and one for global handlers. Everything within the service section is for handlers that are specific to the SOAP action and are only invoked whenever that particular web service is used. Everything within the global section is for handlers that are not specific to a web service and are called regardless of what web service method is called.
When you are defining handlers, note the following important points:
Once the type of handler has been defined, the handler has to be further identified as either a handler to be invoked on the request message flow (that is, within the requestFlow tag) or on the response message flow (that is, within the responseFlow tag) so that:
When declaring a handler association, you must give the handler a unique name (for example, myClientHandlerReq). To identify where AxisClient can locate the handler library, the type attribute value must be a fully qualified path.
<?xml version="1.0" encoding="UTF-8"?> <deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:C="http://xml.apache.org/axis/wsdd/providers/c"> <!--Service Handler Definitions--> <service name="ServiceHandler" provider="CPP:DOCUMENT" description="Service Handlers"> <requestFlow> <handler name="myClientHandlerReq" type="<inst_dir>\wscc\samples\handlers\myClientHandler.dll"> </handler> </requestFlow> <responseFlow> <handler name="myClientHandlerRes" type="<inst_dir>\wscc\samples\handlers\myClientHandler.dll"> </handler> </responseFlow> </service> <!--Global Handler Definitions--> <globalConfiguration name="GlobalHandler" provider="CPP:DOCUMENT" description="Global Handler"> <requestFlow> <handler name="myGlobalHandlerReq" type="<inst_dir>\wscc\samples\handlers\myGlobalHandler.dll"> </handler> </requestFlow> <responseFlow> <handler name="myGlobalHandlerRes" type="<inst_dir>\wscc\samples\handlers\myGlobalHandler.dll"> </handler> </responseFlow> </globalConfiguration> </deployment>