Configuring the JAX-RPC client deployment descriptor for handler classes

You can 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 Platform, Enterprise Edition (Java EE) specification and chapter 12 of the Java API for XML-based remote procedure call (JAX-RPC) specification. The application modules must contain the webservices.xml (for server) and the client deployment descriptors.

For a complete list of the supported standards and specifications, see the web services specifications and API documentation.

About this task

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

Procedure

  1. Start an assembly tool. Read about starting the assembly tool in the Rational® Application Developer information.
  2. If you have not done so already, configure the assembly tool so that it works on Java EE modules. You need to make sure that the Java EE and Web categories are enabled. Read about configuring the assembly tool in the Rational Application Developer information.
  3. Migrate the web application archive (WAR) or Java archive (JAR) files that are created with the Assembly Toolkit, Application Assembly Tool (AAT) or a different tool to the Rational Application Developer assembly tool. Read about importing WAR or JAR files using an assembly tool in the Rational Application Developer information.
  4. Configure the client deployment descriptor. Read about creating web services handlers in the Rational Application Developer information.

Results

You have a client deployment descriptor that is configured.

What to do next

Test the web services client. See the testing web services-enabled clients information to learn more about 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: Jan 30, 2014 9:17:32 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-nd-iseries&topic=twbs_atkclientddhandler
File name: twbs_atkclientddhandler.html