| 目次 | 前へ | 次へ | 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) を参照してください。
たとえば、リモートインタフェースのメソッドが次の名前とシグニチャーを持っている場合、
void myRemoteMethod(int count, Object obj, boolean flag)リモートメソッドの名前および記述子を含む文字列は、次のようになります。
myRemoteMethod(ILjava/lang/Object;Z)V64 ビットハッシュ値は、8 バイトシーケンスのリトルエンディアン構成です。最初の 4 バイトはメッセージダイジェストの最初の 32 ビット値 (ビッグエンディアンのバイト順) で、あとの 4 バイトはメッセージダイジェストの 2 番目の 32 ビット値 (ビッグエンディアンのバイト順) です。たとえば、メッセージダイジェストの最初の 2 つの 32 ビット値が
0xB0B1B2B3 および 0xB4B5B6B7 の場合、ハッシュ値は 0xB7B6B5B4B3B2B1B0 になります。
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) インタフェースハッシュ値をメッセージダイジェストから作成する方法は、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 を返します。