Configuring the webservices.xml deployment descriptor for handler classes

This topic explains how to use and assembly tool to configure the webservices.xml deployment descriptor for user-provided handler classes.

Before you begin

You can configure deployment descriptors with assembly tools provided with WebSphere Application Server.

A handler class is a class that is written to modify a SOAP message that represents a remote procedure call (RPC) request or response. Handlers can be associated with a Web service or a Web service client.

To complete this task, you need an enterprise archive (EAR) file for the applications that you want to configure. For some handler use, such as logging or tracing, only the server or client application require configuration. For other handler use, including sending information in the SOAP headers, the client and server applications must be configured with symmetrical handlers.

The modules in the EAR file contain the handler classes to configure. These classes implement the javax.xml.rpc.handler.Handler interface. For more information on writing handler classes, see Chapter 6 of the Web Services for J2EE specification and Chapter 12 of the JAX-RPC specification available through Web services: Resources for learning. The application modules must contain the webservices.xml deployment descriptor.

About this task

Configure a handler in the webservices.xml deployment descriptor by following the listed steps:

Procedure

  1. Start an assembly tool. See "Starting WebSphere Application Server Toolkit" in the Application Server Toolkit documentation for more information.
  2. If you have not done so already, configure the assembly tool to work on J2EE modules. Make sure that the J2EE and Web categories are enabled. See "Configuring WebSphere Application Server Toolkit" in the Application Server Toolkit documentation for more information.
  3. Migrate the Web archive (WAR) files that are created with the Assembly Toolkit, Application Assembly Tool (AAT) or a different tool to an Application Server Toolkit or assembly tools. To migrate files, import your WAR files to the assembly tool. See "Importing Web archive (WAR) files" in the Application Server Toolkit documentation for more information.
  4. Configure the client deployment descriptor. See "Editing Web services" in the Application Server Toolkit documentation for more information.



In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 2:56:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=twbs_atkddhandler
File name: twbs_atkddhandler.html