Configure the JAX-RPC client deployment descriptor for handler classes

 

This topic explains how to configure the JAX-RPC client deployment descriptor for user-provided handler classes.

We need an enterprise archive (EAR) file for the applications to configure. For some handler use, such as logging or tracing, only the server or client application needs to be configured. For other handler use, including sending information in SOAP headers, the client and server applications must be configured with symmetrical handlers.

The modules in the EAR file should 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 Java API for XML-based remote procedure call (JAX-RPC) specification available through Web services: Resources for learning. The application modules must contain the webservices.xml(for server) and the client deployment descriptors.

 

Overview

Configure a handler in the client deployment descriptor by following the steps provided:

 

Procedure

1. Start an assembly tool. See "Starting WAS 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. Verify the J2EE and Web categories are enabled. See "Configuring WAS Toolkit" in the Application Server Toolkit documentation for more information.

3. Migrate the WAR or Java archive (JAR) files that are created with the Assembly Toolkit, Application Assembly Tool (AAT) or a different tool to an AST or other assembly tools, To migrate files, import your WAR files to the assembly tool. See "Importing WAR files" in the Application Server Toolkit documentation for more information.

4. Configure the client deployment descriptor. See "Creating Web services handlers" in the Application Server Toolkit documentation for more information.

 

Results

You have a client deployment descriptor that is configured.

 

What to do next

Test the Web services client. This task explains how to test an unmanaged client Java archive (JAR) file and an unmanaged client application.

---

Handler class properties

Example: Configuring handler classes for Web services deployment descriptors

 

Related concepts

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/topic/com.ibm.websphere.pmc.nd.doc/concepts/cjw_handler.html

 

Related tasks

Configure the webservices.xml deployment descriptor for handler classes