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

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());