Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Notification (WS-Notification) > Use WS-Notification for publish and subscribe messaging for web services > Configure WS-Notification resources > Configure WS-Notification resources by > Configure JAX-WS handlers
Create 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 v7.0 WS-Notification services.
We can create a new JAX-WS handler configuration by as described in this topic, or by using the createJAXWSHandler command.
This task assumes that we have already created your 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 Load 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 WAS 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
- Start the administrative console.
- Navigate to Service integration -> WS-Notification -> JAX-WS Handlers . The JAX-WS handlers collection form is displayed.
- Click New. The JAX-WS handlers settings form is displayed.
- 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.
- Click OK. The general properties for this item are saved, and the additional properties options are made available.
- 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 Create a new JAX-WS handler list or Modify an existing JAX-WS handler list.
- 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 that are configured for use, as part of a handler list, with JAX-WS based v7.0 WS-Notification services.
WS-Notification
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification
Related
createJAXWSHandler command
WS-Notification troubleshooting tips
JAX-WS Handlers [Collection]
JAX-WS Handlers [Settings]