Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Notification (WS-Notification) > Use WS-Notification for publish and subscribe messaging for web services > Accomplishing common WS-Notification tasks

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

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

Procedure

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 v7.0 WS-Notification service point (for inbound invocation handling) or WS-Notification service (for outbound invocation handling), therefore 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 by or by using the createJAXWSHandler command. By creating a new handler configuration, you make WAS aware of your handler, and you make the handler available for inclusion in one or more handler lists.

4. Create a new JAX-WS handler list. The approach taken in WAS 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 v7.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 v7.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.

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

WS-Notification
Configure JAX-WS handlers
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification

Related

WS-Notification troubleshooting tips

+

Search Tips   |   Advanced Search