java.rmi.server
介面 RemoteRef

所有父級介面：

Externalizable, Serializable

所有已知子介面：

ServerRef

public interface RemoteRef
extends Externalizable

RemoteRef 表示遠端物件的句柄。RemoteStub 使用遠端參考來執行對遠端物件的遠端方法調用。

從以下版本開始：

JDK1.1

另請參見：

RemoteStub

欄位摘要

static String	packagePrefix 初始化伺服器套件的前綴：假定伺服器 ref 類別（如 UnicastRef、UnicastServerRef）的實作位於由前綴定義的套件中。
static long	serialVersionUID 指示與類別的 JDK 1.1.x 版本的相容性。

方法摘要

void	done(RemoteCall call) 已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值解組，而不是使用對遠端參考（newCall、invoke 和 done）的方法調用序列。
String	getRefClass(ObjectOutput out) 返回要在串流 'out' 上序列化的 ref 型別的類別名稱。
void	invoke(RemoteCall call) 已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值解組，而不是使用對遠端參考（newCall、invoke 和 done）的方法調用序列。
Object	invoke(Remote obj, Method method, Object[] params, long opnum) 調用某個方法。
RemoteCall	newCall(RemoteObject obj, Operation[] op, int opnum, long hash) 已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值的解組，而不是使用該 stub 的遠端參考（newCall、invoke 和 done）上的方法調用序列。
boolean	remoteEquals(RemoteRef obj) 比較兩個遠端物件是否相等。
int	remoteHashCode() 返回遠端物件的雜湊碼。
String	remoteToString() 返回表示此遠端物件的參考的 String。

從介面 java.io.Externalizable 繼承的方法

readExternal, writeExternal

欄位詳細資訊

serialVersionUID

static final long serialVersionUID

指示與類別的 JDK 1.1.x 版本的相容性。

另請參見：

常數欄位值

packagePrefix

static final String packagePrefix

初始化伺服器套件的前綴：假定伺服器 ref 類別（如 UnicastRef、UnicastServerRef）的實作位於由前綴定義的套件中。

另請參見：

常數欄位值

方法詳細資訊

invoke

Object invoke(Remote obj,
              Method method,
              Object[] params,
              long opnum)
              throws Exception

調用某個方法。將方法調用委託給參考的這一形式允許該參考認真設置到遠端主機的連接，編組方法和參數的某一表示形式，然後將該方法調用傳送到遠端主機。此方法既會返回對位於遠端主機上遠端物件的方法調用的結果，也會在調用失敗時拋出 RemoteException，或者在遠端調用拋出異常時拋出應用程序級的異常。

參數：

obj - 套件含 RemoteRef（如該物件的 RemoteStub）的物件。

method - 要調用的方法

params - 參數列表

opnum - 可以用於表示該方法的雜湊碼

返回：

遠端方法調用的結果

拋出：

Exception - 如果在遠端方法調用過程中發生任何異常

從以下版本開始：

1.2

newCall

@Deprecated
RemoteCall newCall(RemoteObject obj,
                              Operation[] op,
                              int opnum,
                              long hash)
                   throws RemoteException

已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值的解組，而不是使用該 stub 的遠端參考（newCall、invoke 和 done）上的方法調用序列。

創建一個用於對此物件進行新的遠端方法調用的適當調用物件。傳遞操作陣列和索引允許 stub 產生器來分派操作索引，並解釋它們。遠端參考可能需要該操作以便在調用中編碼。

參數：

obj - 要通過它進行調用的遠端 stub

op - stub 操作的陣列

opnum - 操作數

hash - stub/skeleton 介面雜湊碼

返回：

表示遠端調用的調用物件

拋出：

RemoteException - 如果初始化新的遠端調用失敗

從以下版本開始：

JDK1.1

另請參見：

invoke(Remote,java.lang.reflect.Method,Object[],long)

invoke

@Deprecated
void invoke(RemoteCall call)
            throws Exception

已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值解組，而不是使用對遠端參考（newCall、invoke 和 done）的方法調用序列。

執行遠端調用。調用將啟動應該通過的但未被 stub 捕獲的所有“使用者”異常。如果在遠端調用過程中啟動任何異常，則調用在啟動“使用者”或遠端異常之前應小心清除連接。

參數：

call - 表示遠端調用的物件

拋出：

Exception - 如果在遠端方法調用的過程中發生任何異常

從以下版本開始：

JDK1.1

另請參見：

invoke(Remote,java.lang.reflect.Method,Object[],long)

done

@Deprecated
void done(RemoteCall call)
          throws RemoteException

已過時。 1.2 樣式 stub 不再使用此方法。stub 使用遠端參考上的單個方法 invoke(Remote, Method, Object[], int) 來執行參數編組、遠端方法執行和返回值解組，而不是使用對遠端參考（newCall、invoke 和 done）的方法調用序列。

允許遠端參考以清除（或重新使用）連接。只有該調用成功（無例外）返回到 stub 時才調用 Done。

參數：

call - 表示遠端調用的物件

拋出：

RemoteException - 如果在調用 cleanup 過程中發生遠端錯誤

從以下版本開始：

JDK1.1

另請參見：

invoke(Remote,java.lang.reflect.Method,Object[],long)

getRefClass

String getRefClass(ObjectOutput out)

返回要在串流 'out' 上序列化的 ref 型別的類別名稱。

參數：

out - 要在其中序列化參考的輸出串流

返回：

參考型別的類別名稱（不附帶包條件）

從以下版本開始：

JDK1.1

remoteHashCode

int remoteHashCode()

返回遠端物件的雜湊碼。參考同一遠端物件的兩個遠端物件 stub 將有相同的雜湊碼（以便作為雜湊表中的鍵支持遠端物件）。

返回：

遠端物件的雜湊碼

從以下版本開始：

JDK1.1

另請參見：

Hashtable

remoteEquals

boolean remoteEquals(RemoteRef obj)

比較兩個遠端物件是否相等。返回指示此遠端物件是否與指定物件等效的 boolean。在雜湊表中存儲遠端物件時將使用此方法。

參數：

obj - 要與之比較的物件

返回：

如果這些物件相等，則返回 true；否則，返回 false。

從以下版本開始：

JDK1.1

另請參見：

Hashtable

remoteToString

String remoteToString()

返回表示此遠端物件的參考的 String。

返回：

表示遠端物件參考的字元串

從以下版本開始：

JDK1.1