5.9 RMIFailureHandler インタフェース

java.rmi.server.RMIFailureHandler インタフェースは、サーバソケットの作成に失敗した場合 (オブジェクトのエクスポートの実行中を除く) に、RMI ランタイムがどのように対応すればよいかを指定する手段を提供します。

package java.rmi.server;

public interface RMIFailureHandler {

	public boolean failure(Exception ex);
}

failure メソッドは、RMI ランタイムが java.net.ServerSocket の作成に失敗した時の例外を引数として呼び出されます。ランタイムがリトライするべき場合にメソッドは true を返し、そうでない場合には false を返します。

このメソッドが呼び出される前に、失敗用ハンドラが RMISocketFactory.setFailureHandler の呼び出しによって登録されていなければなりません。失敗用ハンドラが設定されていなければ、RMI ランタイムはしばらく待ったあとに、ServerSocket を再度作成しようとします。

オブジェクトの最初のエクスポート時に ServerSocket の作成に失敗した場合は、RMIFailureHandler は呼び出されません。作成の失敗が ServerSocket 上で受け入れられたあとで、ServerSocket を作成しようとすると、RMIFailureHandler が呼び出されます。