Applying a JAX-WS handler list to a WS-Notification service

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

This task assumes that we have already created a Version 7.0 WS-Notification service.

To create a JAX-WS handler, we 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:

• We can use a handler list on the NotificationBroker web service to log all notification messages received by this service point.

• We can use a handler list on a SubscriptionManager web service to log all unsubscribe requests received by this service point.

• We can use a handler list on a PublisherRegistrationManager web service to log all publisher deregistration requests received by this service point.

1. Create one or more JAX-WS handlers. We can do this using IBM Rational Application Developer or a similar tool.

2. 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 to monitor.

3. Create a new JAX-WS handler configuration using the administrative console or using the createJAXWSHandler command. By creating a new handler configuration, we make WebSphere Application Server aware of the handler, and we make the handler available for inclusion in one or more handler lists.

4. 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).

5. 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:

   1. Navigate to Service integration -> WS-Notification -> Services -> service_name -> [Additional Properties] WS-Notification service points or Service integration -> Buses -> bus_name -> [Services] WS-Notification services -> service_name -> [Additional Properties] WS-Notification service points. 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.

   2. 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.

   3. 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.

6. Optional: To apply a JAX-WS handler list to a WS-Notification service, use the administrative console to complete the following substeps:

   1. Navigate to Service integration -> WS-Notification -> Services or Service integration -> Buses -> bus_name -> [Services] WS-Notification services. The WS-Notification services [Collection] form is displayed.

   2. 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.

   3. 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.

Related concepts

WS-Notification

Related tasks

Use WS-Notification for publish and subscribe messaging for web services

Secure WS-Notification

Configure JAX-WS handlers

WS-Notification troubleshooting tips