Java 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的调用都是通过接口进行的，因此我们只能定义接口。代码如下：

package cn.sunline.suncard.server.rmi;

import java.rmi.Remote;
import java.rmi.RemoteException;

/**
 * 远程调用接口
 * @author    tpf
 * @version   1.0  2012-2-25
 */

public interface HelloInterface extends Remote {

	  /**
	    * 远程接口方法必须抛出 java.rmi.RemoteException
	    */
	   public String say(String name) throws RemoteException;
}

第二步，给出具体实现，这个实现和普通类没有什么区别，只是需要继承一个特殊的类：

package cn.sunline.suncard.server.rmi.impl;

import java.rmi.RemoteException;
import java.rmi.server.UnicastRemoteObject;

import cn.sunline.suncard.server.rmi.HelloInterface;

/**
 * 远程调用方法实现
 * @author    tpf
 * @version   1.0  2012-2-25
 */

public class HelloImpl extends UnicastRemoteObject implements HelloInterface {

	private String msg;
	
	/**
	 * @param msg
	 * @throws RemoteException
	 */
	public HelloImpl(String msg) throws RemoteException {
		this.msg = msg;
	}

	@Override
	public String say(String name) throws RemoteException {
		System.out.println("Called by HelloClient-->"+name);    
		return msg; 
	}

}

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

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

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

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

package cn.sunline.suncard.server.rmi.register;

import java.net.MalformedURLException;
import java.rmi.AlreadyBoundException;
import java.rmi.Naming;
import java.rmi.RemoteException;
import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;

import cn.sunline.suncard.server.rmi.HelloInterface;
import cn.sunline.suncard.server.rmi.impl.Hello;

/**
 * 服务器端绑定这个远程对象
 * @author    tpf
 * @version   1.0  2012-2-25
 * @see       [相关类/方法]
 * @since     [产品/模块版本] 
 */

public class HelloServer {

	public static void main(String[] args) {
		try {
			//启动RMI注册服务，指定端口为1099　（1099为默认端口）    
			//也可以通过命令 ＄java_home/bin/rmiregistry 1099启动    
			//这里用这种方式避免了再打开一个DOS窗口    
			//而且用命令rmiregistry启动注册服务还必须事先用RMIC生成一个stub类为它所用    

			//创建远程对象的一个或多个实例，下面是hello对象    
			//可以用不同名字注册不同的实例    
			HelloInterface hello = new Hello("Hello, world!");
			
			Registry r = LocateRegistry.createRegistry(1099);
//			r.bind("Hello", hello);
			
			//把hello注册到RMI注册服务器上，命名为Hello    
			Naming.rebind("Hello", hello);

			//如果要把hello实例注册到另一台启动了RMI注册服务的机器上    
			//Naming.rebind("//192.168.1.105:1099/Hello",hello);    
			System.out.println("Hello Server is ready.");
		} catch (RemoteException e) {
			 System.out.println("Hello Server failed A: " + e);
			e.printStackTrace();
		} catch (MalformedURLException e) {
			// TODO Auto-generated catch block
			e.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.sunline.suncard.server.rmi.register.HelloServer
　　 第九步，启动客户端调用程序，命令如下：
　　 java cn.sunline.suncard.client.rmi.HelloClient

部署时候需要注意的是，客户端都应该包含接口和实现对应的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.sunline.suncard.client.rmi.HelloClient

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

grant{
permission java.security.AllPermission;
};

客户端调用的类如下：

package cn.sunline.suncard.client.rmi;

import java.net.MalformedURLException;
import java.rmi.Naming;
import java.rmi.NotBoundException;
import java.rmi.RMISecurityManager;
import java.rmi.RemoteException;
import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;

import cn.sunline.suncard.server.rmi.HelloInterface;

/**
 * 客户端调用类
 * @author    tpf
 * @version   1.0  2012-2-25
 */

public class HelloClient {

	public static void main(String[] args) throws MalformedURLException {
		System.setProperty ("java.security.policy", HelloClient.class.getResource ("server.policy").toString ());    
		System.setSecurityManager(new RMISecurityManager());
		try {
			System.out.println("111111111111");
//			HelloInterface hello = (HelloInterface) Naming.lookup("rmi://localhost:1099/Hello");
//			HelloInterface hello = (HelloInterface) Naming.lookup("Hello");
//			Registry r = LocateRegistry.getRegistry("127.0.0.1", 1099);
//			HelloInterface hello = (HelloInterface) r.lookup("Hello");
//			System.out.println("00000000000000="+hello);

			//如果要从另一台启动了RMI注册服务的机器上查找hello实例    
			HelloInterface hello = (HelloInterface)Naming.lookup("Hello");
			//调用远程方法    
			System.out.println(hello.say("pengfei"));
		} catch (RemoteException e) {
			e.printStackTrace();
		} catch (NotBoundException e) {
			e.printStackTrace();
		}   

	}
}

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