Creating a new JAX-WS handler list

Create a Java™ API for XML-based Web Services (JAX-WS) handler list for use with Version 7.0 WS-Notification services.

Before you begin

You can create a new JAX-WS handler list by using the administrative console as described in this topic, or by using the createJAXWSHandlerList command.

You can only add previously-configured handlers to a handler list. To configure a handler, see Creating a new JAX-WS handler configuration.

About this task

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

Procedure

  1. Start the administrative console.
  2. Navigate to Service integration > WS-Notification > JAX-WS Handler Lists . The JAX-WS handler lists collection form is displayed.
  3. Click New. The JAX-WS handler lists settings form is displayed.
  4. Type the following general properties:
    Name
    Type the name by which the handler list is known.
    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: \ / , # $ @ : ; " * ? < > | = + & % '
    For example TestList.
    Description
    Type the (optional) description of the handler list.
    JAX-WS handlers
    In the JAX-WS handlers pane, complete the following steps:
    1. Select one or more handlers from the list of available JAX-WS handlers, then click Add to move the selected handlers into the list of handlers for this JAX-WS handler list.
    2. 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.
    Handlers are applied in the sequence in which they appear in the handler list.
    Note: If you 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.
  5. Click OK. The general properties for this item are saved.
  6. Save your changes to the master configuration.

Results

If the processing completes successfully, the list of handler lists is updated to include the new handler list. 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 Creating a new Version 7.0 WS-Notification service point or Modifying a Version 7.0 WS-Notification service point. To apply this handler list to outbound notification requests sent by your Version 7.0 WS-Notification service, associate the handler list with the service as described in Creating a new Version 7.0 WS-Notification service or Modifying 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 Applying a JAX-WS handler list to a WS-Notification service.

  • Modifying an existing JAX-WS handler list

    Modify the configuration details for a Java API for XML-based Web Services (JAX-WS) handler list that is configured for use with Version 7.0 WS-Notification services.

  • Deleting JAX-WS handler lists

    DeleteJava API for XML-based Web Services (JAX-WS) handler lists that are configured for use with Version 7.0 WS-Notification services.

Task topic    

Terms of Use | Feedback

Last updated: Oct 22, 2010 12:21:29 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-zos&topic=tjwsn_jaxws_handler_list_new
File name: tjwsn_jaxws_handler_list_new.html