RPC（Remote Procedure Calls）

Remote Procedure Calls
Rich Internet Applications (RIA)
JavaScript Object Notation (JSON)
在任何时候，只要你需要把代码运行在两个不同的地方，你就需要一种方法让它们之间相互通讯。最简单的方法是通过远程过程调用。
远程过程调用是一种简单的方法，客户端可以执行服务器上的一些逻辑并得到一个返回结果。
RMI，.NET Remoting，SOAP，REST和XML-RPC都是远程过程调用协议，但GWT不使用它们中任意一个。
1、GWT采用新协议的原因
（1）浏览器的调用是异步的；
（2）GWT的RPC需要简单化；
在首次使用时，浏览器下载所有的代码来开始应用程序，如果代码量大于100K，或许人们会感觉到一个停顿。而且，在浏览器上运行JavaScript往往是相当慢的。因此，执行一个复杂的协议如SOAP需要太多的代码下载，实际上太慢了。
（3）JavaScript不支持Java风格的序列化（串行化）类或动态类加载，因此GWT的RPC不能依靠它。
2、GWT RPC基础
GWT是以Java为中心的：客户端的Java被转化成JavaScript，服务器端的Java作为Java Servlet来运行。
（1）建立远程过程调用的第一步是定义一个模板来描述调用。
你需要做三次：客户端一次、服务器端一次、两者之间的共享接口一次。
例：假定你的客户端需要查看股票的价格。要预防非正式的通信，你应该允许它（客户端）一次请求几只股票的价格。因此，你需要一个方法来传递一个标记名数组，并返回double数组。让我们在接口中留住这个方法，调用StackService。你需要定义三个接口或类。
-------------------------------------------------------------------
名字                    位置                      目标
StockService接口        客户端和服务器端          描述服务
StockServiceImpl类      服务器端                  实际的代码
StockServiceAsync接口   客户端                    让你调用服务
-------------------------------------------------------------------
在Eclipse中建立RpcExample项目，使用脚手架工具，加入com.xyz.server包。
RpcProject/src/com/xyz/server/StockServiceImpl.java
-------------------------------
public class StockServiceImpl extends RemoteServiceServlet
          implements StockService{
  public double[] getPrices(String[] symbols){
    double[] result=new double[symbols.length];
    for(int i=0;i<symbols.length;i++){
      result[i]=getPrice(symbols[i]);
    }
    return result;
  }
}
-------------------------------
让我们来看所有的股价在400美元并且每次上涨1美元的股票。
RpcProject/src/com/xyz/server/StockServiceImpl.java
-------------------------------
pricate double price=400.0;
pricate synchronized double getPrice(String symbol){
  return price++;
}
-------------------------------
现在返回到客户端，这里是入口点（EntryPoint）类。
RpcProject/src/com/xyz/client/RpcExample.java
-------------------------------
public class RpcExample implements EntryPoint, ClickListener{
  private Button button=new Button("Click me");
  private HTML label=new HTML();
  private void onModuleLoad(){
    button.addClickListener(this);
    RootPanel.get("slot1").add(button);
    RootPanel.get("slot2").add(label);
  }
  //.......
}
-------------------------------
当点击按钮时，onClick()方法被调用。你实际上是向服务器发出请求。
RpcProject/src/com/xyz/client/RpcExample.java
-------------------------------
private String[] symbols={"GooG","MSFT","SUNW"};
public void onClick(Widget sender){
  //建立客户端代理。异步方式
  StockServiceAsync service=(StockServiceAsync)GWT.create(StockService.class);
  //指定URL
  ServiceDefTarget endpoint=(ServiceDefTarget)service;
  endpoint.setServiceEntryPoint(GWT.getModuleBaseURL()+"prices");
  //创建异步返回处理结果
  AsyncCallback callback=new AsyncCallback(){
    public void onSuccess(Object result){
      double[] prices=(double[]) result;
      updatePrices(symbols, prices);
    }
    public void onFailure(Throwable cauht){
      //生成一些UI东东来显示错误
    }
    //请求调用
    service.getPrices(symbols,callback);
  }
}
-------------------------------
StockServiceAsync和StockService接口可以手动的取得，通过一些工具（如Ruby脚本）从StockServiceImpl类得到。如下：
RpcProject/src/com/xyz/client/StockServiceAsync.java
-------------------------------
public interface StockServiceAsync{
  void getPrices(String[] symbols, AsyncCallback callback);
}
-------------------------------
RpcProject/src/com/xyz/client/StockService.java
-------------------------------
public interface StockService extends RemoteService{
  double[] getPrices(String[] symbols);
}
-------------------------------
现在来看第三步的onClick()方法。当getPrice()方法完成后，那么在AsyncCallback类的onSuccess()方法将被执行。这转变并调用一个名为updatePrices()的方法，它改变用户界面，显示出结果。如下定义：[iocblog.net 来源]
RpcProject/src/com/xyz/client/RpcExample.java
-------------------------------
private void updatePrices(String[] symbols, double[] prices){
  String html="";
  for(int i=0;i<symbols.length;i++){
    html+=symbols[i]+": "+prices[i]+"<br/>";
  }
  label.setHTML(html);
}
-------------------------------
当你运行程序并点击按钮时，并不发生任何事。主机shell将显示一条错误信息：
-------------------------------
[TRACE] The development shell servlet received a request for
    'prices' in module 'com.xyz.RpcExample'
[WARN] Resource not found: prices
-------------------------------
这是因为我们还没有部署servlet代码。在Web模式下，你需要部署StockServiceImpl servlet到容器中，如Tomcat。查看Servlet容器的文档弄清怎样做。
在主机模式下它是很容易的。你只需加它到组件定义（RpcExample.gwt.xml）中即可。
RpcProject/src/com/xyz/RpcExample.gwt.xml
-------------------------------
<!-- Specify the servlet class. -->
<servlet path="/prices" class="com.xyz.server.StockServiceImpl"/>
-------------------------------
现在重启应用程序，一切OK。
（2）Server-based State
每次你点击按钮时，价格将递增，即使你在不同的浏览器进行点击。这是因为一个servlet实例被所有的客户端所共享。要想不同的用户有不同的状态，你需要执行多种会话ID。
（3）Serialization 串行化
在早先的例子中，你递交了一系列字符串，返回了一系列double值。
就像RMI和.NET Remoting，你不用限制初始类型。任何类型均能作为一个参数串行化传递，并从远程调用返回结果。
要记住：GWT的串行化概念不同于Java的串行化概念。
GWT的串行化类型有：
  （1）is primitive, such as char, byte, short, int, long, boolean, float, or double;
  （2）is a primitive wrapper (Character, Byte, etc.);
  （3）is String or Date
  （4）is an array of serializable types (including arrays of arrays);
  （5）is a user defined class that contains only serializable fields, or implements the IsSerializable marker interface.
你使用的大多数简单类型和类都可以自动地被串行化，例如：
RpcProject/src/com/xyz/client/Rect.java
-------------------------------
public class Rect implements IsSerializable{
  private int height;
  private int width;
  //Must have a zero-rg constructor, or no constructor
  public Rect(){
  }
  public void setHeight(int height){
    this.height=height;
  }
  //...
}
-------------------------------
对于集合类如Set、List、Map和HashMap，你必须在JavaDoc中使用特殊的annotation类来告诉GWT编译器是哪种集合。例如：
RpcProject/src/com/xyz/client/MyClass.java
-------------------------------
public class MyClass implements IsSerializable{
  /**
   * This field is a Set that must always contain Strings.
   *
   * @gwt.typeArgs<java.lang.String>
   */
  public Set setOfStrings;
}
类似，注解参数和返回值：
RpcProject/src/com/xyz/server/MyService.java
-------------------------------
public interface MyService extends RemoteService{
  /**
   * The first annotation indicates that the parameter named 'c' is
   * a List that will only contain Integer objects. The second
   * annotation indicates that the returned List wil only contain
   * String objects (notice there is no need for a name, since it
   * is a return value).
   *
   * @gwt.typeArgs c <java.lang.Integer>
   * @gwt.typeArgs <java.lang.String>
   */
  List reverseListAndConvertToStrings(List c);
}