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.