| 目次 | 前の項目 | 次の項目 | Java Remote Method Invocation |
RemoteRef インタフェースRemoteRefインタフェースは、リモートオブジェクトへのハンドルを表します。それぞれのスタブは、RemoteRefのインスタンスを持ち、そのインスタンスは参照の具体的な表現を含みます。このリモート参照は、参照されているリモートオブジェクトへのリモート呼び出し実行に使われます。
package java.rmi.server;
public interface RemoteRef extends java.io.Externalizable {
Object invoke(Remote obj,
java.lang.reflect.Method method,
Object[] params,
long opnum)
throws Exception;
RemoteCall newCall(RemoteObject obj, Operation[] op, int opnum,
long hash) throws RemoteException;
void invoke(RemoteCall call) throws Exception;
void done(RemoteCall call) throws RemoteException;
String getRefClass(java.io.ObjectOutput out);
int remoteHashCode();
boolean remoteEquals(RemoteRef obj);
String remoteToString();
}
invoke(Remote,Method,Object[],long)メソッドは、メソッド呼び出しをスタブの (obj) リモート参照に委譲します。 委譲により、この参照はリモートホストへの接続のセットアップ処理を引き受け、method およびパラメータ params の表現を整列化してから、リモートホストへのメソッド呼び出しを伝えます。このメソッドは、リモートホスト上のリモートオブジェクトへのメソッド呼び出しの結果を返すか、または呼び出しが失敗した場合はRemoteExceptionをスローし、リモート呼び出しによって例外をスローした場合はアプリケーションレベルの例外をスローします。操作番号 opnum は、メソッドシグニチャーのハッシュを表し、転送用のメソッドの符号化に使うこともできます。opnum パラメータに使用されるメソッド hash は、64 ビット (long) の整数で、米国国立標準技術研究所 (NIST) の Secure Hash Algorithm (SHA-1) により、バイトストリームのメッセージダイジェストの最初の 2 つの 32 ビット値から計算されます。このバイトストリームには、
java.io.DataOutput.writeUTFメソッドを使って記述された場合と同様にリモートメソッドの名前のあとにメソッド記述子を続けた文字列が含まれています。メソッド記述子の説明については、『Java 仮想マシン仕様』(JVMS) の 4.3.3 節を参照してください。たとえば、リモートインタフェースのメソッドが次の名前とシグニチャーを持っている場合、
void myRemoteMethod(int count, Object obj, boolean flag)
リモートメソッドの名前および記述子を含む文字列は、次のようになります。
myRemoteMethod(ILjava/lang/Object;Z)V
64 ビットハッシュ値は、8 バイトシーケンスのリトルエンディアン構成です。最初の 4 バイトはメッセージダイジェストの最初の 32 ビット値 (ビッグエンディアンのバイト順) で、後の 4 バイトはメッセージダイジェストの 2 番目の 32 ビット値 (ビッグエンディアンのバイト順) です。たとえば、メッセージダイジェストの最初の 2 つの 32 ビット値が0xB0B1B2B3および0xB4B5B6B7の場合、ハッシュ値は0xB7B6B5B4B3B2B1B0になります。
注 - Java 2 SDK, Standard Edition, v1.2 では、newCall(RemoteObject,Operation[],int,long)、invoke(RemoteCall)、およびdone(RemoteCall)メソッドの使用は推奨されていません。1.2 のスタブプロトコルバージョンを使ったrmicによって生成されたスタブは、これらのメソッドを現在は使用しません。newCall、invoke、およびdoneで構成される呼び出しのシーケンスは、Methodオブジェクトをパラメータの 1 つにとる新しいinvokeメソッドに置き換えられました。
newCallメソッドは、リモートオブジェクト obj 上での新しいリモートメソッド呼び出し用の適切な呼び出しオブジェクトを作成します。操作配列 op は、リモートオブジェクト上で利用可能な複数の操作を含みます。操作番号 opnum は、操作配列の中の今回のリモート呼び出しで使用する特定の操作を指定するためのインデックスです。インタフェース「ハッシュ」は、v1.1 スタブプロトコルを使用するスタブとスケルトン間の互換性維持に使用する 64 ビット値です。インタフェースハッシュは、SHA-1 を使用する特定のバイトストリームのメッセージダイジェストの最初の 2 つの 32 ビット値から計算されます。このバイトストリームに含まれるデータの書き込みは、java.io.DataOutputインタフェースのwriteIntおよびwriteUTFメソッドを使用した場合と同じ方法で行われます。データには次の項目が含まれます。
( int) スタブのバージョン番号 (常に 1)リモートメソッドごと、かつ操作番号順:
- (UTF-8) リモートメソッド名
- (UTF-8) リモートメソッド記述子 (JVMS の 4.3.3 節を参照)
- 宣言された例外ごと、かつバイナリ名の辞書式順:
- (UTF-8) 例外クラスの名前
インタフェースハッシュ値をメッセージダイジェストから作成する方法は、
invokeメソッドで使用するメソッドハッシュに関してすでに説明した方法と同じです。
invoke(RemoteCall)メソッドは、リモート呼び出しを実行します。invokeは、すべての「ユーザー (user) 定義」例外を発生させます。 この例外は、スタブではキャッチせずに通過させるものです。リモート呼び出しの途中でなんらかの例外が発生した場合には、invokeは、ユーザー定義例外またはRemoteExceptionを発生させる前に接続のクリーンアップを行います。
doneメソッドは、リモート参照に接続のクリーンアップ (または再利用) を許可します。doneが呼び出されるのは、invoke呼び出しが正常に行われて (例外を発生させずに) 終了し、スタブに戻った場合だけです。
getRefClassメソッドは、直列化されてストリームに出力 (out) される参照タイプ内でパッケージ修飾されていないクラス名を返します。
remoteHashCodeメソッドは、リモートオブジェクトの ハッシュコードを返します。同一のリモートオブジェクトを参照する 2 つのリモートオブジェクトスタブは (リモートオブジェクトをハッシュテーブル上のキーとしてサポートするために) 同じハッシュコードを持ちます。RemoteObjectは、hashCodeメソッドへの呼び出しをリモート参照のremoteHashCodeメソッドへ転送します。
remoteEqualsメソッドは、2 つのリモートオブジェクトを比較して異同判定します。2 つのリモートオブジェクトは、両者が同一のリモートオブジェクトを参照するとき等しいとされます。たとえば、2 つのスタブは両者が同一のリモートオブジェクトを参照するならば等しいとされます。RemoteObjectは、そのequalsメソッドへの呼び出しをリモート参照のremoteEqualsメソッドへ転送します。
remoteToStringメソッドは、そのリモートオブジェクトへの参照を表すStringを返します。