WebSphere Web Services Client for C++, Version 1.0.1 Operating Systems: Linux, Solaris

WSDD file

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.

A typical WSDD file

<?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>

Reference topic

Terms of Use | Rate this page

Timestamp iconLast updated: 12 Dec 2005
(C) Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)