WebSphere WebSphere Application Server Version 6.1.x Feature Pack for Web Services Operating Systems: AIX, HP-UX, i5/OS, Linux, Solaris, Windows, z/OS

Creating a new 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 inbound and outbound ports, and take appropriate action depending upon the sender and content of each message. Create a JAX-RPC handler configuration for use, as part of a handler list, with service integration bus-deployed Web services.

Before you begin

This task assumes that you have already created your JAX-RPC handler. You can do this using WebSphere Studio Application Developer (WSAD) or a similar tool. For more information, see the IBM developerWorks article Support for J2EE Web Services in WebSphere Studio Application Developer V5.1 -- Part 3: JAX-RPC Handlers.

You must also make the handler class available to the server or cluster that hosts the port for the service that you want to monitor, as detailed in Loading JAX-RPC handler classes.

About this task

To make WebSphere Application Server aware of your JAX-RPC handler, and to make the handler available for inclusion in one or more handler lists, you use the administrative console to create a new JAX-RPC handler configuration.

To configure an existing JAX-RPC handler for use (as part of a handler list) with service integration bus-deployed Web services, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Service integration > Web services > JAX-RPC handlers. The JAX-RPC handlers collection form is displayed.
  2. Click New. The JAX-RPC handlers settings form is displayed.
  3. Type the following general properties:
    Name
    Type the name by which the handler 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 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.
  4. Click OK. The general properties for this item are saved, and the additional properties options are made available.
  5. 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).
  6. 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.
Related concepts
Service integration technologies and JAX-RPC handlers
Related tasks
Creating a new JAX-RPC handler list
Sending Web service messages directly over the bus from a JAX-RPC client
Related reference
Implementing JAX-RPC handlers to access SDO messages
JAX-RPC: Core Web services API in the Java platform
Getting 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

Task topic

Terms of use | Feedback


Timestamp icon Last updated: 27 November 2008
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.pmc.wsfep.multiplatform.doc/tasks/tjw_jaxrpc_handler_new.html

Copyright IBM Corporation 2004, 2008. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)