Create a JAX-RPC handler configuration for use, as part of a handler
list, with service integration bus-deployed web services. Handlers monitor messages at ports, and take appropriate action depending upon the sender and content of each message.
About this task
A Java™ API for XML-based remote procedure calls (JAX-RPC) 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
- In the navigation pane, click . The JAX-RPC
handlers collection form is displayed.
- Click New. The JAX-RPC
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, 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. For example com.ibm.jaxrpc.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.
- Click OK. The general properties
for this item are saved, and the additional properties options are made available.
- Type the following additional properties:
- SOAP roles
- Add SOAP actor definitions to the list of SOAP roles in which this handler
acts. For more information, see the SOAP specification.
- JAX-RPC headers
- Add JAX-RPC header definitions (Namespace URI and Local part) to the list
of JAX-RPC headers against which this handler operates. JAX-RPC headers are
SOAP headers that are processed by a JAX-RPC handler.
- Custom properties
- Add custom properties (name/value pairs, where the name is a property
key and the value is a string value that can be used to set internal system
configuration properties).
- 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-RPC handler list or
Modifying an existing JAX-RPC handler list.