GWT2.0-RPC编程规范

（1）、RPC service接口采用jdk5中引入的Annotation机制编写, 如需要增加XxxService接口, 其书写如下：

@RemoteServiceRelativePath("xxx.rpc")
public interface XxxService extends RemoteService {
  String stringTest(String name) throws IllegalArgumentException;
 
  void voidTest(String name);
}

(2)、RPC 异步service接口中回调类必须指定具体泛型类, 特别针对service方法返回void类型时, 回调类中泛型类应该指定为Void类型。如需要增加XxxService接口的异步接口XxxServiceAsync, 其书写如下：

public interface XxxServiceAsync {
void stringTest(String input, AsyncCallback<String> callback)
throws IllegalArgumentException;

void voidTest(String input, AsyncCallback<Void> callback);
}

(3)、对RPC异步Service接口的使用, 可以更加简洁

建议用法：
XxxServiceAsync xxxService = GWT.create(XxxService.class);

不建议用法：
XxxServiceAsync xxxService = (XxxServiceAsync)GWT.create(XxxService.class);
      ServiceDefTarget xxxServiceDefTarget = (ServiceDefTarget)xxxService;
      String xxxServiceResponseURL = GWT.getModuleBaseURL() + "xxx.rpc";
      xxxServiceDefTarget.setServiceEntryPoint(xxxServiceResponseURL);


(4)、针对RPC servlet配置, 不建议也不需要在*.gwt.xml中配置, 但必须在web.xml中配置, 样例如下：
<servlet>
<servlet-name>xxx.rpc</servlet-name>
<servlet-class>com.huawei.iread.rpctest.server.XxxServiceImpl</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>xxx.rpc</servlet-name>
<url-pattern>/rpctest/xxx.rpc</url-pattern>
</servlet-mapping>