Create a new JAX-RPC handler list
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. Create a JAX-RPC handler list for use with service integration bus-enabled web services.
We can only add previously-configured handlers to a handler list. To configure a handler, see Create a new JAX-RPC handler configuration.
Handlers monitor messages at ports, and take appropriate action depending upon the sender and content of each message. To enable handlers to undertake more complex operations, you chain them together into handler lists. The approach taken in WebSphere Application Server is to apply handler lists (rather than individual handlers) at the ports, where each handler list contains one or more handlers.
To create a new JAX-RPC handler list, use the console to complete the following steps:
- In the navigation pane, click Service integration -> Web services -> JAX-RPC Handler Lists. The JAX-RPC handler lists collection form is displayed.
- Click New. The JAX-RPC handler lists settings form is displayed.
- Type the following general properties:
- Name
- Type the name by which the handler list 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 TestList.
- Description
- Type the (Optional) description of the handler list.
- JAX-RPC handlers
- In the JAX-RPC handlers pane...
Handlers are applied in the sequence in which they appear in the handler list.
- Select one or more handlers from the list of available JAX-RPC handlers, then click Add to move the selected handlers into the list of handlers for this JAX-RPC handler list.
- Select a handler in the list of handlers for this JAX-RPC handler list, then click Up or Down to change the position of the handler within the list.
If we click Reset, only the Name and Description fields are reset to their state when the form was first loaded. The two lists of available and assigned handlers are not reset.
- Click OK. The general properties for this item are saved.
- Save the changes to the master configuration.
Results
If the processing completes successfully, the list of handler lists is updated to include the new handler list. Otherwise, an error message is displayed.
What to do next
To use this handler list, select it for use with a web service as described in Modify an existing inbound service configuration or Modify an existing outbound service configuration.
Subtopics
- Modify an existing JAX-RPC handler list
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. Modify the configuration details for a JAX-RPC handler list that has been configured for use with service integration bus-deployed web services.
- Delete JAX-RPC handler lists
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. Delete JAX-RPC handler lists configured for use with service integration bus-deployed Web services.
Related concepts
Service integration technologies and JAX-RPC handlers
Implement JAX-RPC handlers to access SDO messages JAX-RPC: Core web services API in the Java platform Get Started with JAX-RPC A developer introduction to JAX-RPC, Part 2: Mine the JAX-RPC specification to improve web service interoperability Support for J2EE Web Services in WebSphere Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers
Related information:
Create a new JAX-RPC handler configuration Sending web service messages directly over the bus from a JAX-RPC client