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 JAX-WS based Version 7.0 WS-Notification services.

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

This task assumes that we have already created the handler. We can do this by using IBM Rational Application Developer or a similar tool. We 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) to monitor, as detailed in Loading JAX-WS handler classes.

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 the handler, and to make the handler available for inclusion in one or more handler lists, you use the console to create a new handler configuration.

1. Start the 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.

   We 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 the 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 Modify an existing JAX-WS handler list.

Subtopics

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

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

Related concepts

WS-Notification

Related tasks

Use WS-Notification for publish and subscribe messaging for web services

Secure WS-Notification

WS-Notification troubleshooting tips

createJAXWSHandler command

Related information:

Loading JAX-WS handler classes

Create a new JAX-WS handler list

JAX-WS Handlers [Collection]

JAX-WS Handlers [Settings]