支持状态对象复用的RPC框架——SnakeRPC

来源：互联网发布：php url post参数传递编辑：程序博客网时间：2024/06/04 19:11

SnakeRPC是我2年前（春节期间！）做的一个RPC框架，现与大家分享。

设计SnakeRPC的主要动机是，Hessian返回的状态对象（如：数据库连接对象、文件对象等）无法复用，而且它对Stream类型的参数数目有限制。SnakeRPC完美的解决了这两个问题。

托管地址：https://github.com/bluejoe2008/snake-rpc

如下附上项目说明，以后有空了会附上中文版：）

snake-rpc

An RPC framework based on Hessian(http://hessian.caucho.com)

the name 'snake' comes from the Animal Year of snake in Chinese(the year 2013).

compared with hessian, snake-rpc has several new features:

ablity to serialize InputStream/OutputStream;
unlimited InputStream/OutputStream parameters;
ablity to reuse remote objects returned by a method call;

for example:

Connection con = client.getConnection();ResultSet rs = con.queryForResultSet("select * from users");

this feature is very useful for those objects which are valid only on the server-side, e.g, the Connection or ResultSet objects;

see https://github.com/bluejoe2008/snake-rpc/blob/master/test/cn/bluejoe/snake/client/SnakeClientTest.java for example usage.

server side codes

Step 1: since a SnakeServlet class is provided by snake-rpc, users can create a derived classes and register accessible service objects within init() methods:

public class MySnakeServlet extends SnakeServlet{    @Override    public void init(ServletConfig config) throws ServletException    {        super.init(config);        //declares that FileObjects are only avaliable on server side        _skeleton.declareServerSideObjectClass(FileObject.class);        //register an object named file        _skeleton.registerServiceObject("file", new FileObjectImpl(new File("./testdir")));    }}

Step 2: configures the Servet in web.xml as normal.
Step 3: start up web server.

client side codes

Step 1: creates a SnakeClient first:

HttpHost hc = new HttpHost("http://localhost:8080");_client = new SnakeClient(hc, "http://localhost:8080/rpc", "", "");

Step 2: uses createServiceObjectProxy() to retrieve remote object:

FileObject fo = (FileObject) _client.createServiceObjectProxy("file", FileObject.class);

Step 3: now you got the FileObject object, just call methods on it:

FileObject[] cfs = fo.listFiles();Assert.assertEquals(1, cfs.length);FileObject cfs0 = cfs[0];Assert.assertEquals(false, cfs0.isDirectory());Assert.assertEquals(f1.length(), cfs0.length());

0 0