WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

Loading JAX-RPC handler classes

A JAX-RPC handler interacts with messages as they pass into and out of the service integration bus, therefore you make the handler class available to the server or cluster that hosts the inbound or outbound port for the service that you want to monitor.

Before you begin

This task assumes that you have already created your JAX-RPC handler. You can do this using WebSphere Studio Application Developer (WSAD) or a similar tool. For more information, see the IBM developerWorks article Support for J2EE Web Services in WebSphere Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers.

About this task

Before you can configure your JAX-RPC handler for use with service integration bus-deployed Web services, you must make the handler class available. If you want to monitor an inbound port, make the handler class available to the server on which the endpoint listener for that port is located. If you want to monitor an outbound port, make the handler class available to the server on which the outbound port destination is localized.

To make the handler class available to the server or cluster that hosts the port that you want to monitor, you create a shared library for the class then add the shared library to the class loader for the server. To do this, use the administrative console to complete the following steps:

Procedure

  1. Package the class file for your handler as a JAR file, then copy the JAR file into a convenient directory.
  2. Create a shared library for the JAR file:
    1. In the navigation pane, click Environment > Shared Libraries.
    2. Set the scope at which you want the new library to be visible, then click New.
    3. Give the new library a name.
    4. Set the class path to the directory and file name for your handler JAR file.
    5. Save your changes to the master configuration.
    For more information, see Creating shared libraries.
  3. Create a class loader for the server or cluster on which you want to make the JAR file available:
    1. In the navigation pane, click Servers > Application servers > server_name > [Server Infrastructure] Java and process Management > Class loader.
    2. Click New.
    3. Click OK.
    4. Save your changes to the master configuration.
    For more information, see Configuring class loaders of a server.
  4. Add the shared library to the class loader for the server:
    1. In the navigation pane, click Servers > Application servers > server_name > [Server Infrastructure] Java and process Management > Class loader > class_loader_name > [Additional Properties] Shared library references.
    2. Click Add.
    3. Click on the name of your new library, then click OK.
    4. Save your changes to the master configuration.
    For more information, see Associating shared libraries with servers.
What to do next
You are now ready to configure your handler for use (as part of a handler list) with service integration bus-deployed Web services.
Related tasks
Modifying an existing JAX-RPC handler configuration
Deleting JAX-RPC handler configurations

Task topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/tasks/tjw_jaxrpc_handler_class.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)