java rmi例子

JAVA RMI 快速入門實例

本實例爲參考多篇文章寫就而成，網上及書上各類文章介紹如何使用RMI有多種實例可參考，譬如有：

1. 用命令rmiregistry啓動RMI註冊服務的
2. 同時創建存根(stub)和骨架(skeleton)的
3. 只創建存根類的的(jdk1.2以後版本)
4. 通過RemoteRef和rmi://協議字串方式的
5. 比較少講到的用LocateRegistry直接在代碼上啓動RMI註冊服務的。

以上描述並非明顯分類，比如，你總是可以選擇用rmiregistry或者代碼LocateRegistry啓動RMI註冊服務

下面我將介紹一個完整的實例，讓初學者能快速體驗RMI的功用。

分爲以下四個步驟

1. 創建遠程接口及聲明遠程方法（HelloInterface.java）
2. 實現遠程接口及遠程方法（繼承UnicastRemoteObject）(Hello.java)
3. 啓動RMI註冊服務，並註冊遠程對象（HelloServer.java）
4. 客戶端查找遠程對象，並調用遠程方法（HelloClient）
5. 執行程序：啓動服務HelloServer；運行客戶端HelloClient進行調用

具體代碼及對應步驟如下：

1. 創建遠程接口及聲明遠程方法（HelloInterface.java）

java 代碼

package com.unmi;

import java.rmi.*;

/**
 * 遠程接口必須擴展接口java.rmi.Remote
 */
public interface HelloInterface extends Remote
{
   /**
    * 遠程接口方法必須拋出 java.rmi.RemoteException
    */
   public String say() throws RemoteException;
}

2. 實現遠程接口及遠程方法（繼承UnicastRemoteObject）Hello.java

java 代碼

package com.unmi;

import java.rmi.*;
import java.rmi.server.*;

/**
 * 擴展了UnicastRemoteObject類，並實現遠程接口 HelloInterface
 */
public class Hello extends UnicastRemoteObject implements HelloInterface
{
   private String message;

   /**
    * 必須定義構造方法，即使是默認構造方法，也必須把它明確地寫出來，因爲它必須拋出出RemoteException異常
    */
   public Hello(String msg) throws RemoteException
   {
      message = msg;
   }

   /**
    * 遠程接口方法的實現
    */
   public String say() throws RemoteException
   {
      System.out.println("Called by HelloClient");
      return message;
   }
}

3. 啓動RMI註冊服務，並註冊遠程對象（HelloServer.java）

java 代碼

package com.unmi;

import java.rmi.Naming;
import java.rmi.registry.LocateRegistry;

public class HelloServer
{
   /**
    * 啓動 RMI 註冊服務並進行對象註冊
    */
   public static void main(String[] argv)
   {
      try
      {
         //啓動RMI註冊服務，指定端口爲1099　（1099爲默認端口）
         //也可以通過命令 ＄java_home/bin/rmiregistry 1099啓動
         //這裏用這種方式避免了再打開一個DOS窗口
         //而且用命令rmiregistry啓動註冊服務還必須事先用RMIC生成一個stub類爲它所用
         LocateRegistry.createRegistry(1099);

         //創建遠程對象的一個或多個實例，下面是hello對象
         //可以用不同名字註冊不同的實例
         HelloInterface hello = new Hello("Hello, world!");

         //把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 (Exception e)
      {
         System.out.println("Hello Server failed: " + e);
      }
   }
}

4. 客戶端查找遠程對象，並調用遠程方法（HelloClient）

java 代碼

package com.unmi;

import java.rmi.Naming;

public class HelloClient
{
   /**
    * 查找遠程對象並調用遠程方法
    */
   public static void main(String[] argv)
   {
      try
      {
         HelloInterface hello = (HelloInterface) Naming.lookup("Hello");

         //如果要從另一臺啓動了RMI註冊服務的機器上查找hello實例
         //HelloInterface hello = (HelloInterface)Naming.lookup("//192.168.1.105:1099/Hello");

         //調用遠程方法
         System.out.println(hello.say());
      }
      catch (Exception e)
      {
         System.out.println("HelloClient exception: " + e);
      }
   }
}

5. 執行程序：啓動服務HelloServer；運行客戶端HelloClient進行調用

代碼如何編譯這裏就不細講

(1)打開一個Dos窗口執行命令 java com.unmi.HelloServer 啓動服務HelloServer

E:workspaceTestRMIbin>java com.unmi.HelloServer
Hello Server is ready.

運行成功則可以看到 Hello Server is ready

(2)打開另一個Dos窗口執行命令 java com.unmi.HelloClient 運行客戶端程序

E:workspaceTestRMIbin>java com.unmi.HelloClient
Hello, world!

調用成功則可以看到　Hello, world!

並且在啓動服務端的窗口中看到緊跟 Hello Server is ready. 打印出
Called by HelloClient

如果您能一路順暢的執行到這裏，恭喜！您已度過了一個輕快的RMI之旅。

最後來個說明：

本實例中並沒有用到JDK所帶的命令 rmic 編譯實現類得到存根(Stub)類，也沒用命令 rmiregistry 命令來啓動RMI註冊服務。在啓動 rmiregistry之前必須能讓它加載到相應的stub類，這就是造成**_Stub 類找不到的原因。

如果只是按上面的代碼，則服務程序 HelloServer 和客戶端程序 HelloClient 都必須運行在本機(如此則RMI有何意義呢？)；別急，只要修改HelloClient類，使用第二種形式的lookup查找語句,註釋第一條 lookup語句，取消註釋第二條lookup語句

         //HelloInterface hello = (HelloInterface) Naming.lookup("Hello");
        
         //如果要從另一臺啓動了RMI註冊服務的機器上查找hello實例
         HelloInterface hello = (HelloInterface)Naming.lookup("//192.168.1.105:1099/Hello");

其中的IP地址和端口號1099爲 RMI 註冊服務器的IP和端口號，這樣你的HelloClient就可以在另一臺機器運行了，當然HelloInterface類必須能找到（但也可指定參數- Djava.rmi.server.codebase從網絡加載HelloInterface類）。lookup("Hello")默認爲從本機 127.0.0.1的1099端口上查找Hello命令對象，如果第二條語句寫成lookup("192.168.1.105/Hello")與原語句是同等的，因爲默認端口號就是1099。

代碼中 HelloServer 和 HelloClient 省略了設置安全管理器的過程　System.setSecurityManager(new RMISecurityManager());　，如果設置的安全管理則必須編寫相應的訪問策略文件，並且在執行時指定參數

無論是啓動服務端還是客戶端都可以用參數 -Djava.rmi.server.codebase=http://unmi.blogcn.cn/bin 的形式，像JNP一樣從網絡上加載類，這樣更方便於RMI客戶端的部署，如RMI客戶端是一個Applet

可以拿單獨一臺機器運行 rmiregistry (它需要能加載到相應的stub類，設置classpath)或用LocateRegistry.createRegistry(port)，只作爲 RMI遠程對象的RMI集中註冊的服務器，真正提供服務對象只往上註冊，客戶端只需從註冊服務器上查找遠程對象引用，然後調用遠程方法，具體由誰提供服務由註冊服務器來幫助聯絡。

還可以用 RMI Activation 編程方式來實現RMI遠程方法調用，具體請參考　http://java.sun.com/j2se/1.4.2/docs/guide/rmi/activation.html

把HelloServer和HelloClient中的 "//192.168.1.105:1099/Hello 寫成 rmi:/192.168.1.105:1099/Hello 感覺會好看一些，因爲直接感覺就是在處理rmi協議。

參考資料：
1. JAVA RMI Tutorial
2. Getting Started Using RMI
3. JavaRMI入門實戰
4. 使用RMI和CORBA進行分佈式java程序設計
5. Think in java中網絡編程RMI部分