Working with JAX-RPC handlers and clients

The Java™ API for XML-based remote procedure calls (JAX-RPC) provides you with a standard way of developing interoperable and portable web services. You can use JAX-RPC handlers, handler lists and client applications with your service integration bus-enabled web services.

About this task

There are two main elements of JAX-RPC that you can use directly with the service integration bus:
  • JAX-RPC handlers and handler lists.
  • JAX-RPC client applications.

A 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. To create a JAX-RPC handler, you can use a tool such as IBM® Rational® Application Developer. To enable handlers to undertake more complex operations, you chain them together into handler lists. You associate each handler list with one or more ports, so that the handler list can monitor activity at the port, and take appropriate action depending upon the sender and content of each message that passes through the port.

JAX-RPC client applications send and receive web service request and response messages. JAX-RPC client applications that use the IBM JAX-RPC run-time environment can do this in a number of different ways, depending on the bindings in the WSDL document that they are developed against, and the configuration data that is used at run time.

Detailed instructions on how to configure JAX-RPC handlers, handler lists and client applications for use with the service integration bus are provided in the following topics:

What to do next

  • Creating a new JAX-RPC handler configuration

    Create a JAX-RPC handler configuration for use, as part of a handler list, with service integration bus-deployed web services. Handlers monitor messages at ports, and take appropriate action depending upon the sender and content of each message.

  • Creating a new JAX-RPC handler list

    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-enabled web services.

  • Sending web service messages directly over the bus from a JAX-RPC client

  • Implementing JAX-RPC handlers to access SDO messages

    JAX-RPC handlers are invoked during the processing of request and response messages. For messages that are exchanged by using the SOAP protocol, each JAX-RPC handler is passed a SOAP-specific MessageContext object. For other protocols, the IBM web services runtime environment passes a MessageContext object that provides a Service Data Objects view of the message. Service Data Objects (SDO) is an open standard for enabling applications to handle data from different data sources in a uniform way, as data graphs.

Task topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 10:04:34 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-nd-mp&topic=tjw_jaxrpc
File name: tjw_jaxrpc.html