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. Handlers monitor messages at inbound and outbound ports, and take appropriate action depending upon the sender and content of each message. Modify the
configuration details for a JAX-RPC handler that has been configured
for use, as part of a handler list, with service integration bus-deployed
Web services.
Before you begin
If you modify a handler class but do not change the class
name, you do not need to modify the handler configuration as described
in this topic. You just need to stop then restart the servers that host the ports that
this handler monitors.
About this task
To list the handlers, and to view and modify their configuration
details, complete the following steps:
Procedure
- Start the administrative console.
- In the navigation pane, click .
A list of handlers is displayed in a JAX-RPC
handlers collection form.
- Click the name of a handler in the list. The
current JAX-RPC
handlers settings for this handler are displayed.
- Modify the following general properties:
- Name
- Modify the name of the handler. 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: \
/ , # $ @ : ; " * ? < > | = + & % '
Note: When you change a handler name, the system looks up all
objects that refer to it and updates the name.
- Description
- Modify the (optional) description of the handler.
- Class name
- Change the name of the class that is to be instantiated. If you
change the class name, you must also make the new class available
to the servers that
host the ports that this handler monitors, as detailed in Loading JAX-RPC handler classes.
- Modify the following additional properties:
- SOAP roles
- Add, modify or remove SOAP actor definitions from the list of
SOAP roles in which this handler acts. For more information, see the SOAP specification.
- JAX-RPC headers
- Add, modify or remove JAX-RPC header definitions (Namespace URI
and Local part) from 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, modify or remove 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 redisplayed. Otherwise, an error message is displayed.