（转）简单的RPC java实现 .
转；http://blog.csdn.net/jackliang55/article/details/7580563
我也承认，RPC的名声大噪之时是在2003年，那一个“冲击波”病毒(Blaster Worm virus)袭卷全球的一年。而“冲击波”正是用着RPC这把刀来敲开了远程电脑的大门。当然RPC 有更多正面的应用，比如NFS、Web Service等等。
一、RPC的介绍
什么是RPC？Remote Procedure Call，远程过程调用。也就是说，调用过程代码并不是在调用者本地运行，而是要实现调用者与被调用者二地之间的连接与通信。比较严格的定义是：Remote procedure call (RPC) is aprotocol that allows a computer program running on one computer to cause a subroutine on another computer to be executed without the programmer explicitly coding the details for this interaction. When the software in question is written using object-oriented principles, RPC may be referred to as remote invocation orremote method invocation. 这样一讲，容易联想到C/S模式的程序设计，我想是对的。RPC的基本通信模型是基于Client/Server进程间相互通信模型的一种同步通信形式；它对Client提供了远程服务的过程抽象，其底层消息传递操作对Client是透明的。在RPC中，Client即是请求服务的调用者(Caller)，而Server则是执行Client的请求而被调用的程序 (Callee)。
下图是RPC调用协议图：
有很多文章对这张经典的图作了很好的描述，归纳讲即是：首先是建立RPC服务，约定底层的RPC传输通道(UDP或是TCP)。客户端的调用参数根据传输前所提供的目的地址及RPC 上层应用程序号，通过底层的RPC传输通道转至相应的服务器，即RPC Application Porgramme Server。客户端随即处于等待状态，以服务器等待应答或Time Out超时信号。当服务器端获得了请求消息，会根据注册RPC时告诉RPC系统的程序入口地址执行相应的操作，并将结果返回至客户端。当一次RPC调用结束后，相应线程发送相应的信号，客户端程序便继续运行。有三个要素来标识唯一的远程过程：程序号、版本号、过程号。其中，程序号是用来区别一组相关的并且具有唯一过程号的远程过程；一个程序可以有一个或几个不同的版本；而每个版本的程序都包含一系列能被远程调用的过程。（这句比较拗口难读的话，一会儿用代码来解释）同一个版本可以包含有许多可供远程调用的过程，每个过程则有其唯一标示的过程号。通过版本的引入，使得不同版本下的 RPC能同时提供服务。
至于更深入的RPC知识，就超出了文本讨论的东西了，在这里我们主要还是来谈以Java实现的问题。
二、RPC应用开发步骤
由我们上面对于RPC调用协议图的讲解看来，RPC的开发一般涉及三方面：
1.定义客户端、服务器端的通信协议。此处的通信协议是指定义服务过程的名称、调用参数的数据类型、返回参数的数据类型、底层传输类型（UDP/TCP）等等。
2.开发客户端程序。
3.开发服务器端程序。
对于RPC通信协议的生成，最简单的方法是利用协议编译工具。常用的是rpcgen，不过这是一个用于生成实现RPC协议的C程序的生成器。要使用Java来实现的话，我们需要使用另外的生成器，即是下面要讲的Remotetea。
三、工具介绍
说起Remotetea可能有很多朋友都不太熟悉，因为我在网上搜寻关于Remotetea的中文资料一篇也没有。既然如此，我就略为写几笔吧:)
Remotetea是一个基于GNULGPL的开源的项目，它完全在Java 2/1.1平台上实现了ONC/RPC协议；由于是纯的100%的Java编写，所以不需要任何本地的库(native binary/libraries)。
简单的讲，它就是今天我们用于代替rpcgen而开发纯Java的RPC应用的工具。它的特点是：
-
100%的纯Java开发
-
完整的客户端功能，包括portmapper的访问。
-
完整的服务器端功能。
-
有为.x文件设计的纯Java协议编译工具，与rpcgen兼容。
-
基于Java的portmapper。
-
开源的代码；文档支持。
下载Remotetea，请在http://sourceforge.net/project/showfiles.php?group_id=87517 这里察看。下载bin包并解压，可以在classes文件夹中找到jrpcgen.jar、oncrpc.jar和portmap.jar。
四、简单层RPC应用的Java实现
1. RPC的不同层次接口
其实在开发客户端和服务器端的程序时，RPC提供了不同层次的开发例程调用接口。不同层次的接口提供了对RPC不同程度级别的控制。一般可分为五个等级的编程接口：简单层例程、高层例程、中间层例程、专家层例程、底层例程。其中，简单层是为快速开发RPC应用服务而设计的，面向普通RPC应用；关于其他层例程，在这里就暂不提及了。简单层其函数列表如下：
Rpc_reg( )——在某一特定类型的传输层上注册一个过程，以作为提供服务的RPC程序。
Rpc_call( )——可以远程调用特定主机上的特定过程。
Rpc_Broadcast( ) ——向指定类型的所有传输端口上广播一个远程过程调用请求。
实现简单层时，便会用到我们刚才要提到的Remotetea。它可以将以类C语言语法的RPC语言进行源代码编译。在这里先提一下所谓“类C语言语法的RPC语言”。
2. RPC语言及其编译
RPC语言是XDR语言的控制扩展，与XDR语言一样在RFC1014中定义。句法的注意事项：
a. 有两个保留字：“program”和“version”。
b. 一个程序定义中不能出现两次版本名或版本号。
c. 在一个版本的定义中，过程名称至多只能出现一次。
d. 程序标识与常量和类型标识在同一空间中。
e. 只有无符号常数才能被附值给程序，版本和过程。
所用到的文件后缀名为.x，可以称为x-文件。下面即是测试用的一个test.x文件的代码：
//////////////////////////////////////////////////////////
/*
* test.x: TEST Remote Procedure Function
*/
const MAXNAMELEN = 2048; /* maximum length of a test string */
typedef string test_string<MAXNAMELEN>; /* a directory entry */
/*
* THE TEST Remote Procedure Function program definition
*/
program TEST_RPC_FUNCTION_NUMBER
{
version TEST_RPC_FUNCTION_VERSION
{
mcps_string TEST_TEST(string) = 1; /* 这是过程号 */
mcps_string TEST_DO_PROCESS(string) = 2; /* 这是过程号 */
} = 1; /* 这是程序号 */
} = 0x20000001; /* 这是版本号 */
//////////////////////////////////////////////////////////
有这个文件以后，便可以在控制台敲入:java -jar jrpcgen test.x，执行后则会生成这几个文件（jrpcgen可以支持参数编译，请参照Remotetea的文档）：testrpcClient.java、testrpc.java、testrpcServerStub.java、test_string.java。
3. 生成文件说明
通过用jrpcgen编译.x文件，将生成四个java文件，下面看看每个文件是干什么的。
testrpc.java：这个文件相当是c中的.h头文件，它主要包括服务器和客户端程序变量、常量、类型等说明。
test_string.java：从名字可以看出是字符串变量相关的，我想应该也可以这么讲吧。它其实是一个XDR例程，可以对在testrpc.java文件中定义的数据类型进行处理。
testrpcClient.java：客户端的标准程序框架，提供一组特定的在x-文件中定义的远程过程。该框架类继承自OncRpcClientStub类：这是一个抽象类，用于在特定的客户端上构建ONC/RPC程序的基础类。
testrpcServerStub.java：服务器端的标准程序框架，提供一组特定的在x-文件中定义的远程过程。该框架类继承自OncRpcServerStub类并实现OncRpcDispatchable接口：前者也是一个抽象类，用于在特定的服务器端上构建ONC/RPC程序的基础类；后者接口用于分配和处理来自客户端的ONC/RPC请求。
4. 开发客户端程序
有了以上的介绍，形势就开始明朗了。我们的客户端程序只需继承自生成的testrpcClient这个客户端框架类就可以了。代码如下：
//////////////////////////////////////////////////////////
import java.io.IOException;
import java.net.InetAddress;
import java.net.UnknownHostException;
import org.acplt.oncrpc.OncRpcClient;
import org.acplt.oncrpc.OncRpcException;
import org.acplt.oncrpc.OncRpcProtocols;
import testrpcClient ;
/*
* @author Noshoeman
*/
public class TestClient extends testrpcClient {
//可以有很多种构造函数，有较大灵活性，这里只写一种。
/**
* @param host
* @param port
* @param protocol
* @throws OncRpcException
* @throws IOException
*/
public TestClient(InetAddress host, int port, int protocol)
throws OncRpcException, IOException {
super(host, port, protocol);
//不需要做任何事。
}
/**
* @param args
* 这里是测试用的主函数
*/
public static void main(String[] args) {
//我们在单机测试，取得本地信息
System.out.println("--Start client.--");
InetAddress address = null;
try {
address = InetAddress.getLocalHost();
} catch (UnknownHostException e) {
e.printStackTrace();
}
//构造客户端并进行测试
try {
TestClient client = new TestClient(address,2023,OncRpcProtocols.ONCRPC_TCP);
client.TEST_DO_PROCESS ("Hello!");
client.close();
} catch (OncRpcException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
}
//////////////////////////////////////////////////////////
整个过程没有什么需要多提的；注意的是在new客端的时候，端口2023是我随便写的，最后的OncRpcProtocols.ONCRPC_TCP，即是我们在前面的提到的约定底层的RPC传输通道，这里我们使用的是TCP(数值好像是６)，也可以换为UDP。这样，一个简单的客户端测试程序就写好了。
5. 开发服务器端程序
和客户端程序的开发经验类似，也是继承自 testrpcServerStub 这个框架类。与客户端不同的是，在这里我们就需要实现远程过程的响应。示例代码如下：
//////////////////////////////////////////////////////////
import java.net.UnknownHostException;
import java.io.IOException;
import java.net.InetAddress;
import org.acplt.oncrpc.OncRpcException;
import test_string;
import testrpcServerStub;
/**
* @author Noshoeman
*/
public class TestServer extends testrpcServerStub {
/**
* @param bindAddr
* @param port
* @throws OncRpcException
* @throws IOException
*/
public TestServer(InetAddress bindAddr, int port) throws OncRpcException,
IOException {
super(bindAddr, port);
}
/*
* 这是第一个远程过程
* @see testrpcServerStub#TEST_TEST(java.lang.String)
*/
public mcps_string TEST_TEST(String arg1) {
System.out.println("This is test function! " + arg1);
return null;
}
/*
* 这是第二个远程过程
* @see testrpcServerStub#TEST_DO_PROCESS(java.lang.String)
*/
public mcps_string TEST_DO_PROCESS(String arg1) {
System.out.println("Got msg from client: " + arg1);
return null;
}
/**
* 服务器端的主函数
* @param args
*/
public static void main(String[] args) {
try {
System.out.println("Server starting...");
InetAddress address = null;
try {
address = InetAddress.getLocalHost();
System.out.println(address.toString());
} catch (UnknownHostException e) {
System.out.println("-------");
e.printStackTrace();
}
TestServer server = new TestServer(address, 2023);
System.out.println("Is server null? " + (server == null ? true : false));
server.run();
} catch (Exception e) {
e.printStackTrace();
}
}
}
//////////////////////////////////////////////////////////
这样一来，服务器的测试例程就写好了。不愿意用ant来编译的“懒友”(me too)，可以用eclipse建立两个相同的copy工程来分别编译并执行。先run服务器端，然后再run客户端，就可以看到当客户端run起来以后，服务器端的控制台出现字符：
Got msg from client: Hello!
恭喜，大功告成！
6. 一些不愿意见到的事
在这过程中，可能不会太顺利。但其实事情也并非不顺，只是多了些波澜，而往往就是这些波澜，让我们痛苦不堪……
你可能无法正确调用jrpcgen，请注意Java相关的路径设置；如果是在1.5x下尝试始终有问题的话，请换1.4x试试。
你可能会编译不过，请注意引入所需要的jar文件，在下载Remotetea的bin文件中有。
但我在这里其实想说的是在run的时候出错。在run服务器端的时候，控制台打出了:Is server null?false这样的信息，但是在程序坚持一小会儿以后，就会出现：
org.acplt.oncrpc.OncRpcException: ONC/RPC portmap failure
at org.acplt.oncrpc.OncRpcPortmapClient.setPort(OncRpcPortmapClient.java:314)
at org.acplt.oncrpc.server.OncRpcUdpServerTransport.register(OncRpcUdpServerTransport.java:215)
at org.acplt.oncrpc.server.OncRpcServerStub.register(OncRpcServerStub.java:100)
at org.acplt.oncrpc.server.OncRpcServerStub.run(OncRpcServerStub.java:80)
at test.TestServer.main(TestServer.java:89)
如果是遇到的这个错误，那么想说的是恭喜你，因为这表明你的程序本身已经没有问题了；问题只在于portmap。
7. 如何解决ONC/RPC portmap failure
要说清楚怕也是可以写一本小书了。在这里我们不打算细究这个问题，我要说的是如何解决上面遇到的问题。（当然没有遇到的话是甚好）
portmap 即“端口映射”，是一个server , 主要功能是转换 TCP/IP 通讯协定的port号变成 RPC program number , 因为这样客户端才能做RPC calls。
所以，显然，在之前Remotetea包中的一个portmap.jar，则是一个基于Java实现的，兼容Sun的portmap、protocol version 2的ONC/RPC portmap。
这样的话，要解决其实很简单了。如果在Linux下，一般已经在/sbin/portmap下有了，man一下用法，其实就敲入portmap便好；如果在Windows下，则启用在Remotetea包中带的portmap.jar就可以了:java -jar jportmap.jar。如果在Windows下还有问题，请注意在系统管理的“服务(service)”里，有两个关于RPC的服务，打开再试试。当然，在Linux下，也可以同样使用这里的portmap.jar。
唔，好了，就写到这里罢。
