JavaTM Platform
Standard Ed. 6

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 - refnull の場合
メソッドの詳細

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable
このオブジェクトをカプセル化しているプロキシインスタンス proxy 上で発行されたメソッド呼び出しを処理し、その結果を返します。

RemoteObjectInvocationHandler では、このメソッドは次のように実装されています。

method が次のメソッドのいずれかである場合、それらは次のように処理されます。

そうでない場合、リモート呼び出しが次のようにして実行されます。

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

定義:
インタフェース InvocationHandler 内の invoke
パラメータ:
proxy - メソッドが呼び出されるプロキシインスタンス
method - プロキシインスタンス上で呼び出されたインタフェースメソッドに対応する Method インスタンス
args - プロキシインスタンス上でのメソッド呼び出し時に指定された引数の値を含むオブジェクト配列。引数をとらないメソッドの場合は null
戻り値:
プロキシインスタンス上でのメソッド呼び出しから返された値
例外:
Throwable - プロキシインスタンス上でのメソッド呼び出しからスローされた例外
関連項目:

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。