Java Web Services的远端调用

　　微软公司提出.Net概念后很快就被认为是以后网络服务的发展方向，其中的Web service概念更被认为是将来的工业标准（其中的SOAP、WSDL、UDDI已经是标准了）。而作为微软公司的老对手SUN公司自然不甘心落后，不久就开发了SUN-ONE（Sun[tm] Open Net Environment）用来开发Web Services，并提供了Java WSDP(Java Web Services Developer Pack)工具包。
　　Web Services简单的来说就是网络服务，譬如一个商业客户在网络上通过SOAP协议发送一个请求，服务端接收这个请求并处理它，然后发送一个响应给客户端。Web Service程序在服务端需要用容器配置，这个容器可以是一个Servlet容器，如：Tomcat或者是基于EJB之上的J2EE 容器。Web Service还用WSDL（Web Service Description Language）描述自己，这种描述包括Web Service的名字、可以被调用的方法名、这些方法的参数以及发送请求的位置等，这样用户就可以方便地通过WSDL去发现Web Service并取得服务，然后利用Java API for XML-based RPC（JAX-RPC）实现对Web Service的调用。
　　举一个典型的例子，如有个商家想订购商品，他可以直接到去每一家供货商询问，但有一个方便的方法是通过UDDI（Universal Description，Discovery and Integration）注册中心去查找供货商，发现哪些才是自己要找的供货商。因为供货商在注册中心注册他们的Web Service，这样就能被网络潜在的客户所发现。
　　JAX-RPC中有一个工具：xrpcc，它可以根据WSDL产生一个stub类作为客户端的代理，以及一个tie类作为服务端的代理。JAX-RPC将客户端调用转换成一个基于HTTP请求的SOAP消息发送给服务器，服务器收到客户请求，把SOAP消息转换成方法调用并调用服务器的Web Service方法，再通过JAX-RPC将结果包装成SOAP消息形式返回给客户。
　　用JAX-RPC开发Web Service非常的容易。一个Web Service有两个文件：一个是接口，用来定义Web Service的远端可以调用的方法；另外一个实现了这个接口方法的类。
　　如定义了Web Service方法的接口：
　　package coffees;
　　import java.rmi.Remote;
　　import java.rmi.RemoteException;
　　public interface CoffeeOrderIF extends Remote {
　　
　　public Coffee [] getPriceList() //Web Service方法
　　
　　throws RemoteException;
　　
　　public String orderCoffee(String coffeeName, int quantity) //Web Service方法
　　
　　throws RemoteException;
　　
　　}
　　实现了上述接口的类如：
　　package coffees;
　　public class CoffeeOrderImpl implements CoffeeOrderIF {
　　
　　public Coffee [] getPriceList() throws RemoteException; {
　　//方法內容
　　}
　　public String orderCoffee(String coffeeName, int quantity)
　　
　　throws RemoteException; {
　　
　　//方法內容
　　
　　}
　　定义了Web Service，客户就可以进行远端调用了。一个典型的客户调用程序如下：
　　package coffees;
　　public class CoffeeClient {
　　public static void main(String[] args) {
　　
　　try {
　　
　　CoffeeOrderIF coffeeOrder = new
　　
　　CoffeeOrderServiceImpl().getCoffeeOrderIF();//调用服务端的Web Service方法
　　
　　Coffee [] priceList =
　　
　　coffeeOrder.getPriceList()://调用服务端的Web Service方法
　　
　　for (int i = 0; i < priceList.length; i++) {
　　
　　System.out.print(priceList[i].getName() + " ");
　　
　　System.out.println(priceList[i].getPrice());
　　
　　}
　　
　　} catch (Exception ex) {
　　ex.printStackTrace();
　　}
　　}
　　}
　　JAX-RPC可以创建基于RPC(remote procedure calls)和XML的“客户-服务”程序。因为使用的是分布的“客户-服务”模式，RPC机制能使客户运行其它系统的程序。
　　一个远端调用是靠基于XML技术之上的SOAP协议描述与传输的。SOAP协议定义消息封装结构，编码规则和一个描述响应的协定。这些调用和响应是靠SOAP传输的，目前JAX-RPC是基于SOAP1.1和HTTP1.1。
　　尽管JAX-RPC是依靠复杂的协议（SOAP），但JAX-RPC的API对开发者隐藏了复杂性。在服务端，开发者指定接口中可以被远端调用的方法，开发者可以写一个或多个类去实现这些方法。而客户端程序非常容易去编写。通过指定服务端的URI，客户可以简单的调用这些方法。
　　使用JAX-RPC，客户和服务器有一个非常大的优势：平台独立性。并且JAX-RPC不受限制，如：一个JAX-RPC客户能够调用不同平台的Web Service，反之亦然。
　　因为JAX-RPC是使用W3C（World Wide Web Consortium）技术，所以具有扩展性。
　　W3C包括：HTTP、SOAP和WSDL。
　　下面有一个简单的例子说明JAX-RPC的实现：
　　
　　1. 调用一个远端程序：HelloClient程序调用本地stub对象中描述远端Web Service的方法；
　　2. stub对象通过JAX-RPC系统调用程序；
　　3. 系统将远端程序调用转换成SOAP消息并通过HTTP把它传输到服务器去；
　　4. 当服务器接收到客户的SOAP消息，通过JAX-RPC系统将SOAP消息转换成方法调用；
　　5. 调用tie对象中的方法；
　　6. tie调用实现了HelloWorld服务的方法；
　　7. 系统将调用方法的结果转换成SOAP消息响应给客户；
　　8. 客户接收响应来的SOAP消息，分析它并取得方法调用的结果。
　　服务端程序如下：
　　定义Web方法的接口HelloIF.java：
　　package hello;
　　import java.rmi.Remote;
　　import java.rmi.RemoteException;
　　public interface HelloIF extends Remote {
　　
　　public String sayHello(String s) throws RemoteException; // Web 方法，可以被客户调用
　　实现Web方法的类HelloImpl.java：
　　package hello;
　　public class HelloImpl implements HelloIF {
　　public String message ="Hello";
　　public String sayHello(String s) { //具体方法实现
　　return message + s;
　　}
　　}
　　客户程序HelloClient.java：
　　package hello;
　　import javax.xml.rpc.Stub;
　　public class HelloClient {
　　public static void main(String[] args) {
　　
　　try {
　　
　　Stub stub = createProxy();//实现远端调用的对象
　　
　　stub._setProperty(
　　
　　javax.xml.rpc.Stub.ENDPOINT_ADDRESS_PROPERTY,
　　
　　args[0]);
　　
　　HelloIF hello = (HelloIF)stub;
　　
　　System.out.println(hello.sayHello("Duke!"));//调用服务端的方法
　　
　　} catch (Exception ex) {
　　
　　ex.printStackTrace();
　　
　　}
　　
　　}
　　private static Stub createProxy() {
　　
　　// Note: HelloWorld_Impl is implementation-specific.
　　
　　return (Stub)(new HelloWorld_Impl().getHelloIFPort());
　　}
　　}
　　当配置好服务端并编译了客户端HelloClient.java，可以运行客户程序如：ant run ，如果一切正确，将显示：
　　Hello Duke!