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.
For a complete list of the supported standards and specifications, see the web services specifications and API documentation.
Configure a handler in the client deployment descriptor by following the steps provided:
Tasks
- Start an assembly tool. Read about starting the assembly tool in the Rational Application Developer information.
- If we have not done so already, configure the assembly tool so that it works on Java EE modules. We 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.
- Migrate the web application archive (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.
- Configure the client deployment descriptor. Read about creating web services handlers in the Rational Application Developer information.
We have a client deployment descriptor 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 JAR file and an unmanaged client application.
Subtopics
- Handler class properties with JAX-RPC
Handler class properties using JAX-RPC are described.- 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:
Service integration technologies and JAX-RPC handlers Development and assembly tools Configure the webservices.xml deployment descriptor for handler classes Implement JAX-RPC web services clients Testing web services-enabled clients Web services specifications and APIs