To handle the messages that flow to and from an existing
JAX-WS based Version 7.0 WS-Notification service, you must create
JAX-WS handlers, chain them together in the form of a handler list,
then apply the handler list to a NotificationBroker, PublisherRegistrationManager
or SubscriptionManager endpoint at a Version 7.0 WS-Notification service
point (for inbound invocation handling), or apply the handler list
to a WS-Notification service (for outbound invocation handling).
About this task
To create a JAX-WS handler, you can use a tool such as
IBM® Rational® Application Developer. To enable handlers to undertake more complex operations, you chain them together into handler lists. You associate each handler list with one or more JAX-WS based Version 7.0 WS-Notification services or service points, so that the handler list can monitor WS-Notification activity and take appropriate action depending upon the sender and content of each inbound or outbound message. For example:
- You can use a handler list on the NotificationBroker web service
to log all notification messages received by this service point.
- You can use a handler list on a SubscriptionManager web service
to log all unsubscribe requests received by this service point.
- You can use a handler list on a PublisherRegistrationManager web
service to log all publisher deregistration requests received by this
service point.
Procedure
-
Create one or more JAX-WS handlers.
You can
do this using IBM Rational Application
Developer or a similar tool.
-
Load
JAX-WS handler classes.
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.
-
Create a new
JAX-WS handler configuration by using the administrative console or
by using the createJAXWSHandler command.
By creating a new handler configuration, you make WebSphere® Application Server aware
of your handler, and you make the handler available for inclusion
in one or more handler lists.
-
Create
a new JAX-WS handler list.
The approach taken in
WebSphere Application Server is to assign handler lists (rather than individual handlers) to WS-Notification service points (for inbound invocation handling) or WS-Notification services (for outbound invocation handling).
- Optional:
To apply a JAX-WS handler list to
a service provider endpoint (NotificationBroker, PublisherRegistrationManager
or SubscriptionManager) associated with a service point, use the administrative
console to complete the following substeps:
-
Navigate to
or
.
The WS-Notification service points [Collection] form
is displayed. This form shows all the service points configured for
this Version 7.0 WS-Notification service.
-
In the content pane, click the name of a JAX-WS based
Version 7.0 WS-Notification service point in the list.
The
current settings for this Version 7.0 WS-Notification service point
are displayed in the WS-Notification service points [Settings] form.
-
Apply the JAX-WS handler list by selecting it from the
list box for one or more of the following general properties:
-
NotificationBroker JAX-WS handler list
-
The JAX-WS handler list that is applied to inbound requests from an application to the NotificationBroker endpoint of the WS-Notification service point.
-
SubscriptionManager JAX-WS handler list
-
The JAX-WS handler list that is applied to inbound requests from an application to the SubscriptionManager endpoint of the WS-Notification service point.
-
PublisherRegistrationManager JAX-WS handler list
-
The JAX-WS handler list that is applied to inbound requests from an application to the PublisherRegistrationManager endpoint of the WS-Notification service point.
- Optional:
To apply a JAX-WS handler list to
a WS-Notification service, use the administrative console to complete
the following substeps:
-
Navigate to
or
.
The WS-Notification services [Collection] form
is displayed.
-
In the content pane, click the name of a JAX-WS based
Version 7.0 WS-Notification service in the list.
The
current settings for this Version 7.0 WS-Notification service are
displayed in the WS-Notification services [Settings] panel.
-
Apply the JAX-WS handler list by selecting it from the
list box for the following general property:
-
JAX-WS handler list
-
The JAX-WS handler list that is applied to outbound requests from the WS-Notification service.