Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer web services - Bus enabled web services > Enable web services through the service integration bus > Administer the bus-enabled web services resources > Work with JAX-RPC handlers and clients > Create a new JAX-RPC handler configuration


Modify an existing JAX-RPC handler configuration

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 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.

If you modify a handler class but do not change the class name, you do not have to modify the handler configuration as described in this topic. You just have to stop then restart the servers or clusters that host the ports that this handler monitors. To list the handlers, and to view and modify their configuration details, complete the following steps.


Procedure

  1. Start the admin console.

  2. In the navigation pane, click Service integration -> Web services -> JAX-RPC Handlers . A list of handlers is displayed in a JAX-RPC handlers collection form.

  3. Click the name of a handler in the list. The current JAX-RPC handlers settings for this handler are displayed.
  4. 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: \ / , # $ @ : ; " * ? < > | = + & % '

    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, also make the new class available to the servers or clusters that host the ports that this handler monitors, as detailed in Load JAX-RPC handler classes.
  5. 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. 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).

  6. 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.
Service integration technologies and JAX-RPC handlers


Related


http://java.sun.com/developer/technicalArticles/xml/jaxrpc/index.html
http://developer.java.sun.com/developer/technicalArticles/WebServices/getstartjaxrpc/
http://www.ibm.com/developerworks/webservices/library/ws-jaxrpc2/
http://www.ibm.com/developerworks/websphere/library/techarticles/0310_flurry/flurry3.html

+

Search Tips   |   Advanced Search