Introduction
CandleRMI是Java远程方法调用(Remote Method Invocation)的实现，与Sun RMI的实现方式不同，CandleRMI利用Java本身的特性并结合HTTP实现了简单高效的RMI功能。CandleRMI Service 作为Candle Services的一部分，与Candle Server整合在一起。
CandleRMI Facilities
•
不需要生成Stub和Skel文件
•
通过文本的方式注册RMI，不需要单独的注册服务和在程序中实现绑定
•
远程接口和实现不需要继承特殊的类或接口
•
最小资源利用，开发和部署方便
CandleRMI
Architecture
CandleRMI体系结构图中最核心的是中间Remote与Service如何通讯。通讯内容通过HTTP协议以时间顺序分别为：名字查询（Lookup），返回远程对象（Remote Object），方法调用（Method Invoke）和方法返回（Return）。上述四个通讯内容按照HTTP通讯协议的标准封装在两个客户端请求中。
RMI Remote
远程接口封装和定义远程方法。接口是公开的，隐藏了具体的实现部分。Client只能使用接口，接口的设计必须符合规范，并且需要封装必须的远程方法。对于实际的应用来说，远程接口可能按照系统功能模块来分有许多个。一个简单的接口如下：
package cn.candle.demo;
import java.rmi.RemoteException;
/**
* @author zhouj
*
*/
interface Compute {
public String calculate(Double d, String[] args) throws RemoteException;
}
远程接口看上去和一般的接口定义没有任何不同，但是远程方法需要抛出一个远程异常，并且方法参数和返回参数必须是可序列化的对象类。目前版本的CandleRMI并不能把prototype映射为相应的对象类，比如例子中的参数＂Double d＂，不能定义成＂double d＂。
远程接口实现在Server端利用Server VM的资源为Remote提供资源服务和运算。CandleRMI 体系结构图中，远程接口实现类对象需要传递，因此远程接口实现必须是可序列化的对象类。这些规则约束与Sun RMI并没有多大不同，只不过是一个更简单的版本。理解规则以后，编码和运行才能避免常见错误。远程接口具体实现例子如下：
package cn.candle.demo;
import java.io.Serializable;
/**
* @author zhouj
*
*/
public class ComputeImpl implements Compute, Serializable {
/*
*
* @see cn.candle.demo.Compute#calculate
*/
public String calculate(Double d, String[] args) {
double _d = Math.sqrt(d.doubleValue());
return "Square root of " + d.doubleValue() + " is " + _d + " at "
+ args[1];
}
}
Invoke Remote Method
远程接口和实现是开发的重点和核心部分，接下来如何使用远程接口并调用其中的远程方法呢？在Sun RMI规范中有JNDI Naming来帮助查找远程服务；CandleRMI使用类似的规则查询远程接口对应的名称，不过远程接口实现都是在固定的Server上，因此并不需要JNDI命名规则。使用CandleRMI部署你的远程方法调用，开发包是candle0.76版本中的candle-rmi.jar。例子代码如下：
package cn.candle.demo;
import java.rmi.NotBoundException;
import java.rmi.RemoteException;
import cn.candle.rmi.Naming;
/**
* @author zhouj
*
*/
public class TestRMI {
public static void main(String[] args) {
Compute compute = null;
try {
compute = (Compute) Naming.lookup("Compute");
} catch (RemoteException e) {
// TODO 自动生成 catch 块
e.printStackTrace();
} catch (NotBoundException e) {
// TODO 自动生成 catch 块
e.printStackTrace();
}
try {
System.out.println(compute.calculate(new Double(3), new String[] {
"", "Test" }));
} catch (RemoteException e1) {
// TODO 自动生成 catch 块
e1.printStackTrace();
}
}
}
RMI Registry
RMI注册是把远程接口和实现与自定义的名称关联起来。上述例子中远程接口cn.candle.demo.Compute对应的名称是＂Compute＂，可以定义成任意不重复的名字。注意CandleRMI规则中远程服务名称是英文不区分大小写。CandleRMI注册是使用文本文件的方式，固定的文件名称和相对路径为WEB-APP/rmi.registry。文件为普通的Java 资源文本文件，格式如下：
#CandleRMI Registry
compute=cn.candle.demo.ComputeImpl
Run CandleRMI Example
