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.
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.
Procedure
- Package the class file for your handler as a JAR file, then copy
the JAR file into a convenient directory.
Make the handler class
available to the application server in one of the following ways:
- Copy the individual class file into a directory structure under app_server_root/classes that matches the package name of the class, where app_server_root is the root directory for the installation of WebSphere Application Server. For example
a handler class com.ibm.jaxrpc.handler.TestHandler is copied
into the app_server_root/classes/com/ibm/jaxrpc/handler directory.
- Package the class files for all your handlers as a JAR file, then copy it into the app_server_root/lib/app directory.
- Start the administrative console.
- Create a shared library for the JAR file.
- Navigate to .
- Set the scope at which you want the new library to be visible,
then click New.
- Give the new library a name.
- Set the class path to the directory and file name for your handler
JAR file.
- Save your changes to the master configuration.
For more information, see Creating shared libraries.
- Create a class loader for the server or
cluster on which you want to make the JAR file available.
- Navigate to .
- Click New.
- Click OK.
- Save your changes to the master configuration.
For more information, see Configuring class loaders of a server.
- Add the shared library to the class loader for the server.
- Navigate to .
- Click Add.
- Click on the name of your new library, then click OK.
- Save your changes to the master configuration.
For more information, see Associating shared libraries with servers.