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 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 によってスローされた例外がこのメソッドによってスローされます。

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

定義:

invoke、インタフェース: InvocationHandler

パラメータ:

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

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

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

戻り値:

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

例外:

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

関連項目:

UndeclaredThrowableException