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

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

Before you begin

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

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:

Procedure

  1. Create one or more JAX-WS handlers. You 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 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.
  3. 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.
  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 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 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.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 7:37:48 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v701sca&product=was-nd-mp&topic=tjwsn_task_jaxws_hlist
File name: tjwsn_task_jaxws_hlist.html