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-deployed
Web services.
About this task
Handlers monitor messages at inbound and outbound ports, and take appropriate action depending upon the sender and content of each message. To enable JAX-RPC handlers to perform more complex operations they can be chained together into handler lists. The approach taken in WebSphere® Application Server is therefore 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 administrative console
to complete the following steps:
Procedure
- In the navigation pane, click .
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 follow 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, complete the following steps:
- 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.
Handlers are applied in the sequence in which they appear in
the handler list.
Note: If you 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 your 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.