JAX-RPC

 

+

Search Tips   |   Advanced Search

 

Java API for XML-based RPC (JAX-RPC) allows clients to access a Web service as if the Web service was a local object mapped into the client's address space even if the Web service provider is located in another part of the world.

JAX-RPC is done using the XML-based protocol SOAP, which typically rides on top of HTTP.

JAX-RPC defines the mappings between...

A JAX-RPC Web service can be created from a JavaBean or a enterprise bean implementation. You can specify the remote procedures by defining remote methods in a Java interface. You only need to code one or more classes that implement the methods. The remaining classes and other artifacts are generated by the Web service vendor's tools. The following is an example of a Web service interface:

 package com.ibm.mybank.ejb; import java.rmi.RemoteException; import com.ibm.mybank.exception.InsufficientFundsException;
/**
  * Remote interface for Enterprise Bean: Transfer
  */ public interface Transfer_SEI extends java.rmi.Remote {
      public void transferFunds(int fromAcctId, int toAcctId, float amount)
            throws java.rmi.RemoteException;

}
The interface definition in JAX-RPC must follow specific rules:

A client creates a stub and invokes methods on it. The stub acts like a proxy for the Web service. From the client code perspective, it seems like a local method invocation. However, each method invocation gets marshaled to the remote server. Marshaling includes encoding the method invocation in XML as prescribed by the SOAP protocol. The following are key classes and interfaces needed to write Web services and Web service clients:

If you are using a stub to access the Web service provider, most of the JAX-RPC API details are hidden from you. The client creates a ServiceFactory (java.xml.rpc.ServiceFactory). The client instantiates a Service (java.xml.rpc.Service) from the ServiceFactory. The service is a factory object that creates the port. The port is the remote service endpoint interface to the Web service. In the case of DII, the Service object is used to create Call objects, which you can configure to call methods on the Web service's port.

Review the API documentation for a complete list of API's. You can also review several articles about the development of Web services at Web services: Resources for learning.


Sub-topics

RMI-IIOP using JAX-RPC

 

Related concepts

Web Services for J2EE specification

 

Related Reference

Web services: Resources for learning