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

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

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

Task topic    

Terms and conditions for information centers | Feedback

Last updated: April 20, 2014 08:46 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-mp&topic=tjwsn_task_jaxws_hlist
File name: tjwsn_task_jaxws_hlist.html