java.rmi.server
類別 RemoteObjectInvocationHandler

java.lang.Object
  java.rmi.server.RemoteObject
      java.rmi.server.RemoteObjectInvocationHandler

所有已實作的介面：

Serializable, InvocationHandler, Remote

public class RemoteObjectInvocationHandler
extends RemoteObject
implements InvocationHandler

與 Java Remote Method Invocation（Java 遠端方法調用，即 Java RMI）一起使用的 InvocationHandler 介面的實作。此調用處理程序可以與取代預產生 stub 類別的動態代理實例一起使用。

不期望應用程序直接使用此類別。使用具有 UnicastRemoteObject 或 Activatable 的動態代理導出的遠端物件將此類別的實例作為該代理的調用處理程序。

從以下版本開始：

1.5

另請參見：

序列化表格

欄位摘要

從類別 java.rmi.server.RemoteObject 繼承的欄位

ref

建構子摘要

RemoteObjectInvocationHandler(RemoteRef ref)
創建一個用指定 RemoteRef 建構的新 RemoteObjectInvocationHandler。

方法摘要

Object

invoke(Object proxy, Method method, Object[] args) 處理在封裝的代理實例 proxy 上進行的方法調用並返回結果。

從類別 java.rmi.server.RemoteObject 繼承的方法

equals, getRef, hashCode, toString, toStub

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

建構子詳細資訊

RemoteObjectInvocationHandler

public RemoteObjectInvocationHandler(RemoteRef ref)

創建一個用指定 RemoteRef 建構的新 RemoteObjectInvocationHandler。

參數：

ref - 遠端參考

拋出：

NullPointerException - 如果 ref 為 null

方法詳細資訊

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

處理在封裝的代理實例 proxy 上進行的方法調用並返回結果。

RemoteObjectInvocationHandler 按以下方式實作此方法：

如果 method 為以下方法之一，則按下面描述的方式處理：

• Object.hashCode: 返回該代理的雜湊碼值。
• Object.equals: 如果參數 (args[0]) 是動態代理類別的一個實例，且此調用處理程序等於該參數的調用處理程序，則返回 true；否則返回 false。
• Object.toString: 返回該代理的字元串表示形式。

否則，按以下方式進行遠端調用：

• 如果 proxy 不是介面 Remote 的實例，則拋出 IllegalArgumentException。
• 否則，在此調用處理程序的 RemoteRef 上調用 invoke 方法，傳遞 proxy、method、args 和 method 的雜湊碼值（在“Java Remote Method Invocation (RMI) 規範”的 section 8.3 中定義）並返回結果。
• 如果 RemoteRef.invoke 拋出異常，且該異常是一個經檢查的異常，不能指派給由 proxy 類別實作的方法的 throws 子句中的任何異常，則該異常在 UnexpectedException 中包裹且拋出該套件裝的異常。否則，由此方法拋出的 invoke 拋出該異常。

如果包含此調用處理程序的某個有效動態代理類別的實例尚未產生參數，則此方法的語義是不確定的。

指定者：

介面 InvocationHandler 中的 invoke

參數：

proxy - 在其上調用方法的代理實例

method - 與在代理實例上調用的介面方法相對應的 Method 實例

args - 套件含傳入到代理實例上方法調用的參數值的物件陣列；如果該方法不用參數，則為 null

返回：

要從代理實例上的方法調用返回的值

拋出：

Throwable - 從代理實例上的方法調用拋出的異常

另請參見：