Creating a new JAX-WS handler configuration

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

Before you begin

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

This task assumes that you have already created your handler. You can do this by using IBM® Rational® Application Developer or a similar tool. You must also make the handler class available to the server or cluster that hosts the WS-Notification service points (for inbound invocation handling) or WS-Notification services (for outbound invocation handling) that you want to monitor, as detailed in Loading JAX-WS handler classes.

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 make WebSphere® Application Server aware of your handler, and to make the handler available for inclusion in one or more handler lists, you use the administrative console to create a new handler configuration.

Procedure

  1. Start the administrative console.
  2. Navigate to Service integration > WS-Notification > JAX-WS Handlers . The JAX-WS handlers collection form is displayed.
  3. Click New. The JAX-WS handlers settings form is displayed.
  4. Type the following general properties:
    Name
    Type the name by which the handler 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 TestHandler.
    Description
    Type the (optional) description of the handler.
    Class name
    Type the name of the class that is to be instantiated. This name must be a fully qualified java class name. For example com.ibm.jaxws.handler.TestHandler.
    Note: You can configure multiple instances of a handler by creating each instance with a different handler name, and pointing to the same handler class.
  5. Click OK. The general properties for this item are saved, and the additional properties options are made available.
  6. Save your changes to the master configuration.

Results

If the processing completes successfully, the list of handlers is updated to include the new handler. Otherwise, an error message is displayed.

What to do next

To use this handler, add it to a handler list as described in Creating a new JAX-WS handler list or Modifying an existing JAX-WS handler list.
  • Modifying an existing JAX-WS handler configuration

    Modify a Java API for XML-based Web Services (JAX-WS) handler configuration for a handler that is used, as part of a handler list, with Version 7.0 WS-Notification services.

  • Deleting JAX-WS handler configurations

    Delete the configuration for one or more Java API for XML-based Web Services (JAX-WS) handlers that are configured for use, as part of a handler list, with Version 7.0 WS-Notification services.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 3:36:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-iseries&topic=tjwsn_jaxws_handler_new
File name: tjwsn_jaxws_handler_new.html