RMI

RMI是Java对象进行远程访问的一种规范——也就是说，从Java虚拟机（Java Virtual Machine，JVM）而不是特定对象的主机访问。这些对象可能位于拥有JVM的同一个物理主机上，或者位于其他计算机上，并通过某个网络连接到宿主主机（服务器）。规范包括这些对象进行编码的规则，如何定位对象，如何远程调用，方法的参数和计算结果如何在JVM之间传递。RMI的缺省实现是 JRMP（Java Remote Method Protocol），这是一个百分之百的Java实现。此外，RMI也可以使用其它的协议，例如IIOP。

　　 RMI可利用标准Java本机方法接口JNI与现有的和原有的系统相连接。RMI还可利用标准JDBC包与现有的关系数据库连接。RMI/JNI和RMI /JDBC相结合，可帮助您利用RMI与目前使用非Java语言的现有服务器进行通信，而且在您需要时可扩展Java在这些服务器上的使用。RMI可帮助您在扩展使用时充分利用Java的强大功能。

　　 下面我们通过一个例子，来说明怎么构建RMI应用。我们写一个例子，通过RMI获取服务器端的时间。下面是构造这个例子的全部过程。

　　 首先定义一个接口，因为RMI的调用都是通过接口进行的，因此我们只能定义接口。代码如下：


Java代码 
1.import java.rmi.Remote;  
2.import java.rmi.RemoteException;  
3. 
4./** 
5. * 定义一个远程接口，这个接口应该继承Remote 
6. * @author Dirac 
7. */ 
8.public interface PerfectTime extends Remote  
9.{  
10.    /** 
11.     * 因为这个方法是远程调用的，所以它应该抛出RemoteException 
12.     * @param param 
13.     * @return 
14.     * @throws RemoteException 
15.     */ 
16.    String getPerfectTime(String param) throws RemoteException;  
17.} 

　　 第二步，给出具体实现，这里为了增加一些趣味，我们加入了一个名字，并把时间格式化成我们所习惯的格式，然后返回给客户。这个实现和普通类没有什么区别，只是需要继承一个特殊的类：

Java代码 
1.public class PerfectTimeImpl extends UnicastRemoteObject implements PerfectTime  
2.{  
3.    private static final long serialVersionUID = 1793177637034935906L;  
4.    String name = "";  
5.    public PerfectTimeImpl(String name) throws RemoteException  
6.    {  
7.        this.name = name;  
8.    }  
9. 
10.    /** 
11.     * 返回的字符串中包含了服务器端的时间 
12.     */ 
13.    public String getPerfectTime(String param) throws RemoteException  
14.    {  
15.        return param + ": " + name + " is " + new SimpleDateFormat("yyyy年MM月dd  
16.日HH时mm分ss秒SSS毫秒").format (new Date(System.currentTimeMillis()));  
17.    }  
18.} 



　　 我们还可以通过继承RemoteServer来实现这个类，但是需要自己将它导出，方法是在构造函数中调用 UnicastRemoteObject.exportObject(this, 1099)，第二个参数是要绑定的端口号。这里之所以没有显式导入，是因为UnicastRemoteObject已经为我们做了这步工作。

　　 第三步，生成远程接口实现对应的stub，这是通过JDK自带的rmic实现的，命令如下：
    rmic cn.zxm.rmi.PerfectTimeImpl

　　 生成的stub对应的文件名是PerfectTimeImpl_Stub。我们可以在rmic后面跟-keep参数，保留生成的stub源码，这实际上是PerfectTimeImpl的代理，客户端调用的实际上就是这个stub。

　　 第四步，在服务器端绑定这个远程对象，代码如下：


Java代码 
1.import java.net.MalformedURLException;  
2.import java.rmi.Naming;  
3.import java.rmi.RMISecurityManager;  
4.import java.rmi.RemoteException;  
5. 
6./** 
7. * @author Dirac 
8. */ 
9.public class PerfectTimeServer  
10.{  
11.    public static void main(String [] agrs) throws RemoteException  
12.    {  
13.        try 
14.        {  
15.            //服务器端注册远程对象  
16.            PerfectTimeImpl p1 = new PerfectTimeImpl ("Black Stone");  
17.            PerfectTimeImpl p2 = new PerfectTimeImpl ("Anders Heijlsberg");  
18.            Naming.rebind ("p1", p1);  
19.            Naming.rebind ("p2", p2);  
20.            //获得注册的名字列表，并打印出来  
21.            String[] list = Naming.list("");  
22.            for(int j = 0; j < list.length; j++)  
23.            {  
24.                System.out.println("list[" + (j + 1) + "]=" + list[j]);  
25.            }  
26.        }  
27.        catch(MalformedURLException mue)  
28.        {  
29.            mue.printStackTrace ();  
30.        }  
31.    }  
32.} 
import java.net.MalformedURLException;
import java.rmi.Naming;
import java.rmi.NotBoundException;
import java.rmi.RMISecurityManager;
import java.rmi.RemoteException;

/**
* @author Dirac
*/
public class PerfectTimeClient
{
    public static void main(String [] args)
    {
        try
        {
            //客户端获取远程接口
            PerfectTime p1 = (PerfectTime)Naming.lookup ("rmi://localhost:1099/p1");
            PerfectTime p2 = (PerfectTime)Naming.lookup ("rmi://localhost:1099/p2");
            //调用远程接口的方法
            System.out.println (p1.getPerfectTime ("p1"));
            System.out.println (p2.getPerfectTime ("p2"));
        }
        catch(RemoteException re)
        {
            re.printStackTrace ();
        }
        catch(MalformedURLException mue)
        {
            mue.printStackTrace ();
        }
        catch(NotBoundException nbe)
        {
            nbe.printStackTrace ();
        }
    }
}
　　 第六步，设置CLASSPATH变量，方式是在命令行中使用命令set CLASSPATH=类路径，比如我的类路径是E:\study\rmi\classes，那么命令如下：
　　 set CLASSPATH=E:\study\rmi\classes
　　 这一步是必须的，不然向RMI注册机注册的时候会找不到stub。
　　 第七步，启动RMI注册机，启动它的命令也是通过JDK自带的工具完成的，它和javac等工具位于一个目录下，命令如下：
　　 start rmiregistry
　　 start表示另起一个命令行窗口，新窗口和现在的命令行窗口共享同样的设置，比如上面的CLASSPATH。
　　 第八步，启动服务器注册程序，命令如下：
　　 start java cn.zxm.rmi.PerfectTimeServer
　　 第九步，启动客户端调用程序，命令如下：
　　 java cn.zxm.rmi.PerfectTimeClient
　　 输出如图1：

图1 RMI客户端调用结果

　　 部署时候需要注意的是，客户端都应该包含接口和实现对应的stub，其它的则不是必需的。
　　 注册远程接口的时候，如果抛出ClassNotFound stub这样的错误，可能的原因，一是没有手工设置CLASSPATH，二是PATH变量当中，包含了多个JDK或者JRE的bin路径，这两个错误往往很难找，需要格外的注意。

　　 除了在客户端直接部署stub外，还有一种方式，是通过网络获取。比如我把stub放在http://www.zxm.net:8081/order /perfect/下，当然要包含完整的包结构，stub这个例子中stub实际上位于http://www.zxm.net:8081/order /perfect/cn/zxm/rmi/下。客户端调用的方式如下：

　　 java -Djava.rmi.server.codebase=http://www.zxm.net:8081/order/perfect/
cn.zxm.rmi.PerfectTimeClient

　　 注意URL后面的/不可省略。由于从远程加载类，因此涉及到安全问题，java使用许可的方式，来保证安全。这是通过配置一个policy文件实现的，policy文件的配置很麻烦，我们这里由于是测试，不涉及安全问题，因此我们给它全部的许可，许可文件命名为server.policy，和 PerfectTimeClient放在一个目录下，server.policy的内容如下：


Java代码 
1.grant{  
2.    permission java.security.AllPermission;  
3.} 
grant{
    permission java.security.AllPermission;
}

　　 然后，我们需要在客户端手工加载这个文件，并为客户端安装一个安全管理器，代码如下：


Java代码 
1.System.setProperty ("java.security.policy",  
2.PerfectTimeClient.class.getResource ("server.policy").toString ());  
3.System.setSecurityManager(new RMISecurityManager()); 
        System.setProperty ("java.security.policy",
        PerfectTimeClient.class.getResource ("server.policy").toString ());
        System.setSecurityManager(new RMISecurityManager());

　　 这样我们就可以使用动态类加载功能加载服务器上的stub文件了。