Configuring 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.

Before you begin

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 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 Java 2 Platform, Enterprise Edition (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.

About this task

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

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) or Java archive (JAR) files that are created with the Assembly Toolkit, Application Assembly Tool (AAT) or a different tool to an Application Server Toolkit or other 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 "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.



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_atkclientddhandler
File name: twbs_atkclientddhandler.html