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.