WAS v8.5 > Develop applications > Develop web services > Develop JAX-RPC web services clients

Configure the JAX-RPC client deployment descriptor for handler classes

We can configure the JAX-RPC client deployment descriptor for user-provided handler classes.

You need an 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 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.

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

1. Start an assembly tool. Read about starting the assembly tool in the Rational Application Developer information.

2. If we have not done so already, configure the assembly tool so that it works on Java EE modules. You need to verify the Java EE and Web categories are enabled. Read about configuring the assembly tool in the Rational Application Developer information.
3. Migrate the WAR or JAR files 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.

Test the web services client. See the testing web services-enabled clients information to learn more about how to test an unmanaged client JAR file and an unmanaged client application.

Subtopics

• Handler class properties with JAX-RPC
  This article describes handler class properties using JAX-RPC.
• Example: Configuring handler classes for web services deployment descriptors
  This scenario explains how to add a client and server handler class to a sample application, WebServicesSamples.ear. The handler classes display messages when given a request or response to handle.

Related concepts:

Service integration technologies and JAX-RPC handlers
Development and assembly tools

Related

Configure the webservices.xml deployment descriptor for handler classes
Implement JAX-RPC web services clients
Testing web services-enabled clients

Reference:

Web services specifications and APIs

+

Search Tips   |   Advanced Search