RMI規范--第二章 Java 分布式對象模型 2.1 分布式對象應用程序 RMI 應用程序通常包括兩個獨立的程序：服務器程序和客戶機程序。典型的服務 器應用程序將創建多個遠程對象，使這些遠程對象能夠被引用，然後等待客戶機 調用那些遠程對象上的方法。而典型的客戶機程序則從服務器中得到一個或多個 遠程對象的引用，然後調用遠程對象的方法。RMI 為服務器和客戶機進行通訊 和信息傳遞提供了一種機制。這樣的應用程序有時被稱為分布式對象應用程序。 分布式對象應用程序需要： 定位遠程對象 應用程序可使用兩種機制中的一種得到對遠程對象的引用。它既可用 RMI 的簡 單命名工具 rmiregistry 來注冊它的遠程對象；也可將遠程對象引用作為常規 操作的一部分來進行傳遞和返回。 與遠程對象通訊 遠程對象間通訊的細節由 RMI 處理；對於程序員來說，遠程通訊看起來就象標 准的 Java 方法調用。給作為參數或返回值傳遞的對象加載類字節碼因為 RMI 允許調用程序將純 Java 對象傳給遠程對象，所以 RMI 將提供必要的機制， 既可以加載對象的代碼又可以傳輸對象的數據。 服務器調用注冊服務程序以使名字與遠程對象相關聯。客戶機在服務器注冊服務 程序中用遠程對象的名字查找該遠程對象，然後調用它的方法。RMI 能用 Java 系統支持的任何 URL 協議（例如 HTTP、FTP、file 等）加載類字節碼。 2.2 術語的定義 在 Java 分布式對象模型中，remote object 是這樣一種對象：它的方法可以 從其它 Java 虛擬機（可能在不同的主機上）中調用。該類型的對象由一種或 多種 remote interfaces（它是聲明遠程對象方法的 Java 接口）描述。 遠程方法調用 (RMI) 就是調用遠程對象上遠程接口的方法的動作。更為重要的 是，遠程對象的方法調用與本地對象的方法調用語法相同。 2.3 分布式和非分布式模型的比較 Java 分布式對象模型在以下幾方面與 Java 對象模型相似： 遠程對象的引用在任一種方法調用中（本地或遠程）都能以參數形式傳遞或以結 果形式返回。 遠程對象可以被強制轉換成任何遠程界面，只要該界面為使用內置 Java 語法 進行強制類型轉換的實現所支持。 內置 Java 操作符 instanceof 可用來測試遠程對象所支持的遠程接口。 Java 分布式對象模型在以下幾方面與 Java 對象模型不同： 遠程對象的客戶機與遠程接口發生交互，而從不與這些接口的實現類交互。 遠程方法的非遠程參數和返回結果是通過復制而非引用的方式傳遞的。這是因為 對象的引用只在單個虛擬機中才有用。 遠程對象以引用的方式進行傳遞，而不是復制實際的遠程實現。 某些 java.lang.Object 類定義的方法的語義專用於遠程對象。 因為調用遠程對象的失敗模式本來就比調用本地對象的失敗模式復雜，所以客戶 機必須處理遠程方法調用期間發生的額外異常。 2.4 RMI 接口和類概述 2.4.1 java.rmi.Remote 接口 在 RMI 中，遠程接口是聲明了可從遠程 Java 虛擬機中調用的方法集。遠程接 口必須滿足下列要求： 遠程接口至少必須直接或間接擴展 java.rmi.Remote 接口。 遠程接口中的方法聲明必須滿足下列遠程方法聲明的要求： 遠程方法聲明在其 throws 子句中除了要包含與應用程序有關的異常（注意與 應用程序有關的異常無需擴展 java.rmi.RemoteException ）之外，還必須包 括 java.rmi.RemoteException 異常（或它的超類，例如 java.io.IOException 或 java.lang.Exception ）。 遠程方法聲明中，作為參數或返回值聲明的（在參數表中直接聲明或嵌入到參數 的非遠程對象中）遠程對象必須聲明為遠程接口，而非該接口的實現類。 java.rmi.Remote 接口是一個不定義方法的標記接口： public interface Remote 遠程接口必須至少擴展 java.rmi.Remote 接口（或其它擴展 Java.rmi.Remote 的遠程接口）。然而，遠程接口在下列情況中可以擴展非遠 程接口： 遠程接口也可擴展其它非遠程接口，只要被擴展接口的所有方法（如果有）滿足 遠程方法聲明的要求。 例如，下面的接口 BankAccount 即為訪問銀行帳戶定義了一個遠程接口。它包 含往帳戶存款、使帳戶收支平衡和從帳戶取款的遠程方法：
public interface BankAccount extends java.rmi.Remote
{
public void deposit(float amount)
throws java.rmi.RemoteException;
public void withdraw(float amount)
throws OverdrawnException, java.rmi.RemoteException;
public float getBalance()
throws Java.rmi.RemoteException;
}
下例說明了有效的遠程接口 Beta。它擴展非遠程接口 Alpha（有遠程方法）和 接口 Java.rmi.Remote：
public interface Alpha
{
public final String okay = "constants are okay too";
public Object foo(Object obj)
throws java.rmi.RemoteException;
public void bar() throws java.io.IOException;
public int baz() throws java.lang.Exception;
}
public interface Beta extends Alpha, java.rmi.Remote {
public void ping() throws Java.rmi.RemoteException;
}
2.4.2 RemoteException 類 java.rmi.RemoteException 類是在遠程方法調用期間由 RMI 運行時所拋出 的異常的超類。為確保使用 RMI 系統的應用程序的健壯性，遠程接口中聲明的 遠程方法在其 throws 子句中必須指定 java.rmi.RemoteException（或它的 超類，例如 java.io.IOException 或 java.lang.Exception）。 當遠程方法調用由於某種原因失敗時，將拋出 java.rmi.RemoteException 異 常。遠程方法調用失敗的原因包括： 通訊失敗（遠程服務器不可達或拒絕連接；連接被服務器關閉等。） 參數或返回值傳輸或讀取時失敗 協議錯誤 RemoteException 類是一個已檢驗的異常（必須由遠程方法的調用程序處理並 經編譯器檢驗的異常），而不是 RuntimeException。 2.4.3 RemoteObject 類及其子類 RMI 服務器函數由 java.rmi.server.RemoteObject 及其子類 java.rmi.server.RemoteServer、java.rmi.server.UnicastRemoteObject 和 java.rmi.activation.Activatable 提供。 java.rmi.server.RemoteObject 為對遠程對象敏感的 java.lang.Object 方法、hashCode、 equals 和 toString 提供實現。 創建遠程對象並將其導出（使它們可為遠程客戶機利用）所需的方法由類 UnicastRemoteObject 和 Activatable 提供。子類可以識別遠程引用的語義， 例如服務器是簡單的遠程對象還是可激活的遠程對象（調用時將執行的遠程對象）。 java.rmi.server.UnicastRemoteObject 類定義了單體（單路傳送）遠程對 象，其引用只有在服務器進程活著時才有效。 類 java.rmi.activation.Activatable 是抽象類，它定義的 activatable 遠程對象在其遠程方法被調用時開始執行並在必要時自己關閉。 2.5 實現遠程接口 實現遠程接口的類的一般規則如下： 該類通常擴展 java.rmi.server.UnicastRemoteObject，因而將繼承類 java.rmi.server.RemoteObject 和java.rmi.server.RemoteServer 提供 的遠程行為。 該類能實現任意多的遠程接口。 該類能擴展其它遠程實現類。 該類能定義遠程接口中不出現的方法，但這些方法只能在本地使用而不能在遠程 使用。 例如，下面的類 BankAcctImpl 實現 BankAccount 遠程接口並擴展 Java.rmi.server.UnicastRemoteObject 類：
package mypackage;
import java.rmi.RemoteException;
import Java.rmi.server.UnicastRemoteObject;
public class BankAccountImpl extends UnicastRemoteObject implements
BankAccount
{
private float balance = 0.0;
public BankAccountImpl(float initialBalance)
throws RemoteException
{
balance = initialBalance;
}
public void deposit(float amount) throws RemoteException
{
...
}
public void withdraw(float amount) throws OverdrawnException,
RemoteException
{
...
}
public float getBalance() throws RemoteException
{
...
}
}
注意：必要時，實現遠程接口的類能擴展除 java.rmi.server.UnicastRemoteObject 類以外的其它一些類。但實現類此 時必須承擔起一定的責任，即導出對象（由 UnicastRemoteObject 構造函數 負責）和實現從 java.lang.Object 類繼承的 hashCode、 equals 和 toString 方法的正確遠程語義（如果需要）。 2.6 遠程方法調用中的參數傳遞 傳給遠程對象的參數或源於它的返回值可以是任意可序列化的 Java 對象。這包 括 Java 基本類型, 遠程?Java 對象和實現 java.io.Serializable 接口的 非遠程 Java 對象。有關如何使類序列化的詳細信息，參見 Java“對象序列化 規范”。本地得不到的作為參數或返回值的類，可通過 RMI 系統進行動態下載。 有關 RMI 讀取參數、返回值和異常時如何下載參數和返回值類的詳細信息，參 見“動態類加載”(3.4)一節。 2.6.1 傳遞非遠程對象 非遠程對象將作為遠程方法調用的參數傳遞或作為遠程方法調用的結果返回時， 是通過復制傳遞的；也就是使用 Java 對象序列化機制將該對象序列化。 因此，在遠程對象調用過程中，當非遠程對象作為參數或返回值傳遞時，非遠程 對象的內容在調用遠程對象之前將被復制。 從遠程方法調用返回非遠程對象時，將在調用的虛擬機中創建新對象。 2.6.2 傳遞遠程對象 當將遠程對象作為遠程方法調用的參數或返回值傳遞時，遠程對象的 stub 程序 即被傳遞出去。作為參數傳遞的遠程對象僅能實現遠程接口。 2.6.3 引用的完整性 如果一個對象的兩個引用在單個遠程方法調用中以參數形式（或返回值形式）從 一個虛擬機傳到另一個虛擬機中，並且它們在發送虛擬機中指向同一對象，則兩 個引用在接收虛擬機中將指向該對象的同一副本。進一步說就是：在單個遠程方 法調用中，RMI 系統將在作為調用參數或返回值傳遞的對象中保持引用的完整性 。 2.6.4 類注解 當對象在遠程調用中被從一個虛擬機發送到另一個虛擬機中時，RMI 系統在調用 流中用類的信息 (URL) 給類描述符加注解，以便該類能在接收器上加載。在遠 程方法調用期間，調用可隨時下載類。 2.6.5 參數傳輸 為將 RMI 調用的參數序列化到遠程調用的目的文件裡，需要將該參數寫入作為 java.io.ObjectOutputStream 類的子類的流中。ObjectOutputStream 子類 將覆蓋 replaceObject 方法，目的是用其相應的 stub 類取代每個遠程對象。 對象參數將通過 ObjectOutputStream 的 writeObject 方法寫入流中。而 ObjectOutputStream 則通過 writeObject 方法為每個寫入流中的對象（包 含所寫對象所引用的對象）調用 replaceObject 方法。RMIObjectOutputStream 子類的 replaceObject 方法返回下列值： 如果傳給 replaceObject 的對象是 java.rmi.Remote 的實例，則返回遠程對 象的 stub 程序。遠程對象的 stub 程序通過對 java.rmi.server.RemoteObject.toStub 方法的調用而獲得。 如果傳給 replaceObject 的對象不是 java.rmi.Remote 的實例，則只返回 該對象。 RMI 的 ObjectOutputStream 子類也實現 annotateClass 方法，該方法用類 的位置注解調用流以便能在接收器中下載該類。有關如何使用 annotateClass 的詳細信息，參見“動態類加載”一節。 因為參數只寫入一個 ObjectOutputStream，所以指向調用程序同一對象的引用 將在接收器那裡指向該對象的同一副本。在接收器上，參數將被單個 ObjectInputStream 所讀取。 用於寫對象的 ObjectOutputStream（類似的還有用於讀對象的 ObjectInputStream ）的所有其它缺省行為將保留在參數傳遞中。例如，寫對 象時對 writeReplace 的調用及讀對象時對 readResolve 的調用就是由 RMI 的參數編組與解編流完成的。 與上述 RMI 參數傳遞方式類似，返回值（或異常）將被寫入 ObjectOutputStream 的子類並和參數傳輸的替代行為相同。 2.7 定位遠程對象 我們專門提供了一種簡單的引導名字服務器，用於存儲對遠程對象的已命名引用 。使用類 java.rmi.Naming 的基於 URL 的方法可以存儲遠程對象引用。 客戶機要調用遠程對象的方法，則必須首先得到該對象的引用。對遠程對象的引 用通常是在方法調用中以返回值的形式取得。RMI 系統提供一種簡單的引導名字 服務器，通過它得到給定主機上的遠程對象。Java.rmi.Naming 類提供基於統 一資源定位符 (URL) 的方法，用來綁定、再綁定、解開和列出位於某一主機及 端口上的名字-對象對。
