Modifying an existing JAX-WS handler list
Modify the configuration details for a Java API for XML-based Web Services (JAX-WS) handler list configured for use with JAX-WS based Version 7.0 WS-Notification services.
We can modify a JAX-WS handler list using the console as described in this topic, or using the modifyJAXWSHandlerList command.
We can only add previously-configured handlers to a handler list. To configure a handler, see Create a new JAX-WS handler configuration.
A Java API for XML-based Web Services (JAX-WS) handler is a Java class that performs a range of handling tasks. For example: logging messages, or transforming their contents, or terminating an incoming request. To enable handlers to undertake more complex operations, you chain them together into handler lists. 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).
We can use the console to list existing handler lists, and to view and modify their configuration details.
- Start the console.
- Navigate to Service integration -> WS-Notification -> JAX-WS Handler Lists. A list of all the handler lists is displayed in a JAX-WS handler lists collection form.
- Click the name of a handler list in the list. The current JAX-WS handler lists settings for this handler are displayed.
- Modify the following general properties:
- Name
- Modify the name of the handler list.
This name must be unique at cell scope, and it must obey the following syntax rules:
- It must not start with "." (a period).
- It must not start or end with a space.
- It must not contain any of the following characters: \ / , # $ @ : ; " * ? < > | = + & % '
When you change a handler list name, the system looks up all objects that refer to it and updates the name.
- Description
- Modify the (Optional) description of the handler list.
- JAX-WS handlers
- In the JAX-WS handlers pane...
Handlers are applied in the sequence in which they appear in the handler list.
- Select one or more previously-configured handlers from either the list of available JAX-WS handlers or the list of handlers for this JAX-WS handler list, then click Add or Remove to modify the list of handlers for this JAX-WS handler list.
- Select a handler in the list of handlers for this JAX-WS handler list, then click Up or Down to change the position of the handler within the list.
If we click Reset, only the Name and Description fields are reset to their state when the form was first loaded. The two lists of available and assigned handlers are not reset.
- Save the changes to the master configuration.
Results
If the processing completes successfully, the list of handler lists is redisplayed. Otherwise, an error message is displayed.
What to do next
To apply this handler list to inbound notification requests received at a Version 7.0 WS-Notification point, associate it with the service point as described in Create a new Version 7.0 WS-Notification service point or Modify a Version 7.0 WS-Notification service point. To apply this handler list to outbound notification requests sent by the Version 7.0 WS-Notification service, associate the handler list with the service as described in Create a new Version 7.0 WS-Notification service or Modify a Version 7.0 WS-Notification service.
For an overview of the end-to-end task of creating JAX-WS handlers, chaining them together in a handler list, then applying the handler list to a Version 7.0 WS-Notification service point or service, see Apply a JAX-WS handler list to a WS-Notification service.
Related concepts
WS-Notification
Related tasks
Use WS-Notification for publish and subscribe messaging for web services Secure WS-Notification
WS-Notification troubleshooting tips modifyJAXWSHandlerList command showJAXWSHandlerList command
Related information:
Delete JAX-WS handler lists JAX-WS Handler Lists [Settings]