To handle the messages that flow to and from an existing Version 7.0 WS-Notification service, you 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 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 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 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 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.