Network Deployment (Distributed operating systems), v8.0 > Reference > Commands (wsadmin scripting)
createJAXWSHandler command
Use the createJAXWSHandler command to create a new Java API for XML-based Web Services (JAX-WS) handler configuration so that the handler can be used, as part of a handler list, with v7.0 WS-Notification services.
We can create a new JAX-WS handler configuration by using the wsadmin tool as described in this topic, or by using the admin console as described in Create a new JAX-WS handler configuration.
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.
To run the command, use the AdminTask object of the wsadmin scripting client.
Command-line help is provided for service integration bus commands:
- For a list of the available WS-Notification commands, plus a brief description of each command, run at the wsadmin prompt:
print AdminTask.help('WSNotificationCommands')
- For overview help on a given command, run at the wsadmin prompt:
print AdminTask.help('command_name')
After using the command, save changes to the master configuration; for example, by using the following command:
AdminConfig.save()
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. This command creates a new JAX-WS handler configuration so that the handler can be used, as part of a handler list, with v7.0 WS-Notification services.
The configuration object associates a unique name (the name parameter) with a Java class (the className parameter) that refers to the JAX-WS handler implementation.
Target Object
A cell scope object.
Required parameters
-name
The name of the JAX-WS handler configuration object. 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: \ / , # $ @ : ; " * ? < > | = + & % '
-className
The name of the JAX-WS handler class that this configuration object represents. 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.
Conditional parameters
None
Optional parameters
-description
A description of the JAX-WS handler.
Example
Create the configuration for a particular JAX-WS handler class:
### Jython
targetCell = AdminConfig.list('Cell') JAXWSHandler = AdminTask.createJAXWSHandler(targetCell, ["-name", "handler1", "-className", "handlerClass", "-description", "desc"])### Jacl
$AdminTask createJAXWSHandler targetCell {-name handler1 -className handlerClass -description desc}
WS-Notification
Use WS-Notification for publish and subscribe messaging for web services
Secure WS-Notification
Load JAX-WS handler classes
Create a new JAX-WS handler configuration
Related
WS-Notification troubleshooting tips
JAX-WS Handlers [Collection]
JAX-WS Handlers [Settings]