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文件了。