A JAX-WS handler interacts with messages through a JAX-WS based Version 7.0 WS-Notification service point (for inbound invocation handling) or WS-Notification service (for outbound invocation handling), therefore you must make the handler class available to the server or cluster that hosts the WS-Notification service point or service that you want to monitor.
Before you begin
This task assumes that you have already created your handler. You can do this by using IBM® Rational® Application Developer or a similar tool.
About this task
Before
you can configure a JAX-WS handler for use with WS-Notification,
you must make the handler class available to the server or cluster
that hosts
the WS-Notification service point or service that you want to monitor.
To
do this, 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.jaxws.handler.TestHandler is
copied
into the app_server_root/classes/com/ibm/jaxws/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.