Network Deployment (Distributed operating systems), v8.0 > Develop and deploying 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.

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:


Procedure

  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 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 WAR or 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 JAR file and an unmanaged client application.


Related


Handler class properties with JAX-RPC
Example: Configuring handler classes for web services deployment descriptors
Service integration technologies and JAX-RPC handlers
Assembly tools
Configure the webservices.xml deployment descriptor for handler classes
Implement JAX-RPC web services clients
Test web services-enabled clients


Related


Web services specifications and APIs

+

Search Tips   |   Advanced Search