RMI過程實例----轉

 RMI，遠程方法調用（Remote Method Invocation）是Enterprise JavaBeans的支柱，是建立分佈式Java應用程序的方便途徑。RMI是非常容易使用的，但是它非常的強大。

       RMI的基礎是接口，RMI構架基於一個重要的原理：定義接口和定義接口的具體實現是分開的。下面我們通過具體的例子，建立一個簡單的遠程計算服務和使用它的客戶程序

一個正常工作的RMI系統由下面幾個部分組成：

●     遠程服務的接口定義

●     遠程服務接口的具體實現

●     樁（Stub）和框架（Skeleton）文件

●     一個運行遠程服務的服務器

●     一個RMI命名服務，它允許客戶端去發現這個遠程服務

●     類文件的提供者（一個HTTP或者FTP服務器）

●     一個需要這個遠程服務的客戶端程序

下面我們一步一步建立一個簡單的RMI系統。首先在你的機器裏建立一個新的文件夾，以便放置我們創建的文件，爲了簡單起見，我們只使用一個文件夾存放客戶端和服務端代碼，並且在同一個目錄下運行服務端和客戶端。

如果所有的RMI文件都已經設計好了，那麼你需要下面的幾個步驟去生成你的系統：

1、  編寫並且編譯接口的Java代碼

2、  編寫並且編譯接口實現的Java代碼

3、  從接口實現類中生成樁（Stub）和框架（Skeleton）類文件

4、  編寫遠程服務的主運行程序

5、  編寫RMI的客戶端程序

6、  安裝並且運行RMI系統


1、  接口

第一步就是建立和編譯服務接口的Java代碼。這個接口定義了所有的提供遠程服務的功能，下面是源程序：

//Calculator.java
//define the interface
import java.rmi.Remote;

public interface Calculator extends Remote
{
    public long add(long a, long b)
        throws java.rmi.RemoteException;

    public long sub(long a, long b)
        throws java.rmi.RemoteException;

    public long mul(long a, long b)
        throws java.rmi.RemoteException;

    public long div(long a, long b)
        throws java.rmi.RemoteException;
}
注意，這個接口繼承自Remote，每一個定義的方法都必須拋出一個RemoteException異常對象。

建立這個文件，把它存放在剛纔的目錄下，並且編譯。

>javac Calculator.java

2、  接口的具體實現

下一步，我們就要寫遠程服務的具體實現，這是一個CalculatorImpl類文件：

//CalculatorImpl.java
//Implementation
import java.rmi.server.UnicastRemoteObject

public class CalculatorImpl extends UnicastRemoteObject implements Calculator
{

    // 這個實現必須有一個顯式的構造函數，並且要拋出一個RemoteException異常
    public CalculatorImpl()
        throws java.rmi.RemoteException {
        super();
    }

    public long add(long a, long b)
        throws java.rmi.RemoteException {
        return a + b;
    }

    public long sub(long a, long b)
        throws java.rmi.RemoteException {
        return a - b;
    }

    public long mul(long a, long b)
        throws java.rmi.RemoteException {
        return a * b;
    }

    public long div(long a, long b)
        throws java.rmi.RemoteException {
        return a / b;
    }
}
       同樣的，把這個文件保存在你的目錄裏然後編譯他。

       這個實現類使用了UnicastRemoteObject去聯接RMI系統。在我們的例子中，我們是直接的從UnicastRemoteObject這個類上繼承的，事實上並不一定要這樣做，如果一個類不是從UnicastRmeoteObject上繼承，那必須使用它的exportObject()方法去聯接到RMI。

       如果一個類繼承自UnicastRemoteObject，那麼它必須提供一個構造函數並且聲明拋出一個RemoteException對象。當這個構造函數調用了super()，它久激活UnicastRemoteObject中的代碼完成RMI的連接和遠程對象的初始化。



3、  樁（Stubs）和框架（Skeletons）

下一步就是要使用RMI編譯器rmic來生成樁和框架文件，這個編譯運行在遠程服務實現類文件上。

>rmic CalculatorImpl

在你的目錄下運行上面的命令，成功執行完上面的命令你可以發現一個Calculator_stub.class文件，如果你是使用的Java2SDK，那麼你還可以發現Calculator_Skel.class文件。



4、  主機服務器

遠程RMI服務必須是在一個服務器中運行的。CalculatorServer類是一個非常簡單的服務器。

//CalculatorServer.java
import java.rmi.Naming;

public class CalculatorServer {

   public CalculatorServer() {
     try {
       Calculator c = new CalculatorImpl();
       Naming.rebind("rmi://localhost:1099/CalculatorService", c);
     } catch (Exception e) {
       System.out.println("Trouble: " + e);
     }
   }

   public static void main(String args[]) {
     new CalculatorServer();
   }
}
       建立這個服務器程序，然後保存到你的目錄下，並且編譯它。

5、  客戶端

客戶端源代碼如下：

//CalculatorClient.java



import java.rmi.Naming;
import java.rmi.RemoteException;
import java.net.MalformedURLException;
import java.rmi.NotBoundException;

public class CalculatorClient {

    public static void main(String[] args) {
        try {
            Calculator c = (Calculator)
                           Naming.lookup(
                 "rmi://localhost
                        /CalculatorService");
            System.out.println( c.sub(4, 3) );
            System.out.println( c.add(4, 5) );
            System.out.println( c.mul(3, 6) );
            System.out.println( c.div(9, 3) );
        }
        catch (MalformedURLException murle) {
            System.out.println();
            System.out.println(
              "MalformedURLException");
            System.out.println(murle);
        }
        catch (RemoteException re) {
            System.out.println();
            System.out.println(
                        "RemoteException");
            System.out.println(re);
        }
        catch (NotBoundException nbe) {
            System.out.println();
            System.out.println(
                       "NotBoundException");
            System.out.println(nbe);
        }
        catch (
            java.lang.ArithmeticException
                                      ae) {
            System.out.println();
            System.out.println(
             "java.lang.ArithmeticException");
            System.out.println(ae);
        }
    }
}
       保存這個客戶端程序到你的目錄下（注意這個目錄是一開始建立那個，所有的我們的文件都在那個目錄下），並且編譯他。



6、  運行RMI系統

現在我們建立了所有運行這個簡單RMI系統所需的文件，現在我們終於可以運行這個RMI系統啦！來享受吧。

我們是在命令控制檯下運行這個系統的，你必須開啓三個控制檯窗口，一個運行服務器，一個運行客戶端，還有一個運行RMIRegistry。

首先運行註冊程序RMIRegistry，你必須在包含你剛寫的類的那麼目錄下運行這個註冊程序。

>rmiregistry

好，這個命令成功的話，註冊程序已經開始運行了，不要管他，現在切換到另外一個控制檯，在第二個控制檯裏，我們運行服務器CalculatorService，因爲RMI的安全機制將在服務端發生作用,所以你必須增加一條安全策略。以下是對應安全策略的例子
grant {
permission java.security.AllPermission "", "";
};
注意:這是一條最簡單的安全策略,它允許任何人做任何事,對於你的更加關鍵性的應用,你必須指定更加詳細安全策略。
現在爲了運行服務端，你需要除客戶類(CalculatorClient.class)之外的所有的類文件。確認安全策略在policy.txt文件之後,使用如下命令來運行服務器。
> java -Djava.security.policy=policy.txt CalculatorServer

這個服務器就開始工作了，把接口的實現加載到內存等待客戶端的聯接。好現在切換到第三個控制檯，啓動我們的客戶端。
爲了在其他的機器運行客戶端程序你需要一個遠程接口(Calculator.class) 和一個stub(CalculatorImpl_Stub.class)。 使用如下命令運行客戶端
prompt> java -Djava.security.policy=policy.txt CalculatorClient

如果所有的這些都成功運行，你應該看到下面的輸出：

1
9
18
3
如果你看到了上面的輸出，恭喜你，你成功了，你已經成功的創建了一個RMI系統，並且使他正確工作了。即使你運行在同一個計算機上，RMI還是使用了你的網絡堆棧和TCP/IP去進行通訊，並且是運行在三個不同的Java虛擬機上。這已經是一個完整的RMI系統。