WebSphere WebSphere Application Server Network Deployment, Version 6.0.x Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Creating a new JAX-RPC handler configuration

Use this task to create a Java API for XML-based Remote Procedure Call (JAX-RPC) handler configuration for use (as part of a handler list) with service integration bus-deployed Web services.

For information about creating JAX-RPC handlers, see the IBM developerWorks article A developer introduction to JAX-RPC, Part 2: Mine the JAX-RPC specification to improve Web service interoperability.

Before you can create a JAX-RPC handler configuration, you must make the handler class available to the application server in one of the following ways:
  • Copy the individual class file into a directory structure under install_root/classes that matches the package name of the class, where install_root is the root directory for the installation of IBM WebSphere Application Server. Therefore a handler class com.ibm.jaxrpc.handler.TestHandler is copied into the install_root/classes/com/ibm/jaxrpc/handler directory.
  • Package the class files for all your handlers as a JAR file, then copy it into the install_root/lib/app directory.
Note:
  • You can deploy multiple instances of a handler by entering different handler names.
  • When you add a handler class in the install_root/classes directory, you make the handler class potentially available to all application servers on the node. New or changed handler classes are then picked up by each individual application server within the node when you restart that server.
To create a JAX-RPC handler configuration, complete the following steps:
  1. Start the administrative console.
  2. In the navigation pane, click Service integration > Web services > JAX-RPC handlers. The JAX-RPC handlers collection form is displayed.
  3. Click New. The JAX-RPC handlers settings form is displayed.
  4. 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.
  5. Click OK. The general properties for this item are saved, and the additional properties options are made available.
  6. 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).
  7. Apply the changes.
If the processing completes successfully, the list of handlers is updated to include the new handler. Otherwise, an error message is displayed.
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

Task topic

Terms of Use | Feedback

Last updated: 5 Oct 2005
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp?topic=/com.ibm.websphere.pmc.nd.doc\tasks\tjw_jaxrpc_handler_new.html

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