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 リモートメソッド呼び出し (Java RMI) で使用するための InvocationHandler インタフェースの実装です。この呼び出しハンドラは、動的プロキシインスタンスと組み合わせて、事前生成されたスタブクラスの代わりとして使用できます。

アプリケーションがこのクラスを直接使用することは想定されていません。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) 仕様」のセクション 8.3 で定義されている) が渡される。そして、その結果が返される。
• RemoteRef.invoke から例外がスローされ、かつその例外が、proxy のクラスで実装されているメソッドの throws 節に指定されたどの例外にも割り当てられないチェックされる例外であった場合、その例外が UnexpectedException 内にラップされ、そのラップ済み例外がスローされる。そうでない場合は、invoke によってスローされた例外がこのメソッドによってスローされる。

この呼び出しハンドラを含む有効な動的プロキシクラスのインスタンスによって引数が生成されていなかった場合、このメソッドのセマンティクスは不明となります。.

定義:

インタフェース InvocationHandler 内の invoke

パラメータ:

proxy - メソッドが呼び出されるプロキシインスタンス

method - プロキシインスタンスで呼び出されるインタフェースメソッドに対応する Method インスタンス

args - プロキシインスタンスでのメソッド呼び出し時に渡される引数の値が含まれるオブジェクト配列。メソッドが引数をとらない場合は null

戻り値:

プロキシインスタンスでのメソッド呼び出しからの戻り値

例外:

Throwable - プロキシインスタンスでのメソッド呼び出しからスローされる例外

関連項目: