Work 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. We can use JAX-RPC handlers, handler lists and client applications with your service integration bus-enabled web services.
There are two main elements of JAX-RPC that we 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, we 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 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:
Subtopics
- Create 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.
- Create 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
Use this task to send web service messages over a bus by retargeting the JAX-RPC client.
- Implement 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 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.
Subtopics
- Create 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.
- Create 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
Use this task to send web service messages over a bus by retargeting the JAX-RPC client.
- Implement 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 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.
JAX-RPC: Core web services API in the Java platform Get 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