| 目次 | 前 の項目 | 次の項目 | Java Remote Method Invocation |
RMI ランタイム実装には、接続のためにjava.net.Socketおよびjava.net.ServerSocketが必要です。 RMI ランタイム実装は、これらのクラスのオブジェクトを直接インスタンス化するのではなく、static メソッドRMISocketFactory.getSocketFactoryによって返される、現在のRMISocketFactoryオブジェクトのcreateSocketおよびcreateServerSocketメソッドを呼び出します。これにより、アプリケーションは、java.net.Socketおよびjava.net.ServerSocketクラスの代替サブクラスなどの RMI 転送で使われるソケットの種類をカスタマイズするためのフックを保持できます。使用されるRMISocketFactoryのインスタンスは、信頼できるシステムコードによって一度に設定できます。JDK1.1 では、このカスタマイズは、ソケットの種類についての全般的な設定を行う場合に限られていました。 これは、ファクトリのメソッドに渡されるパラメータが、createSocketのhostとport、およびcreateServerSocketのportだけであったためです。Java 2 プラットフォームでは、リモートオブジェクトとの通信にどのプロトコルを使うかについて、より柔軟にカスタマイズできるようにするため、新しいインタ フェース
RMIServerSocketFactoryおよびRMIClientSocketFactoryが導入されました。RMI を使ったアプリケーションで、これらの新しいソケットファクトリインタフェースを利用するために、
UnicastRemoteObjectとjava.rmi.activation.Activatableの両方に、いくつかの新しいコンストラクタおよびexportObjectメソッドが追加されました。 これらのコンストラクタおよびメソッドは、クライアントおよびサーバソケットファクトリを追加されたパラメータとして利用します。この新しいコンストラクタまたは
exportObjectメソッドのどちらかによって (RMIClientSocketFactoryおよびRMIServerSocketFactoryパラメータを使って) エクスポートされるリモートオブジェクトは、RMI ランタイムにより特別に扱われます。リモートオブジェクトの存続期間中、ランタイムは、ServerSocketを作成してリモートオブジェクトへの着呼を受け入れるために、カスタムのRMIServerSocketFactoryを使用し、Socketを作成してクライアントをリモートオブジェクトに接続するために、カスタムのRMIClientSocketFactoryを使用します。カスタムソケットファクトリとともにエクスポートされるリモートオブジェクトのスタブおよびスケルトン内で使われる
RemoteRefおよびServerRefの実装は、それぞれUnicastRef2およびUnicastServerRef2です。UnicastRef型のワイヤの表現では、接続するための「エンドポイント」の表現に、UTF 形式のホスト名文字列とそのあとに整数のポート番号だけを使用していました。UnicastRef2型のワイヤの表現には、これとは異なる表現が含まれています。UnicastRef2では、エンドポイントのワイヤ表現は、残りのエンドポイント表現の内容を指定する形式のバイト (将来のエンドポイント表現の拡張用)、およびそれに続く指定された形式のデータによって構成されています。現在のところ、データは、UTF 形式のホスト名、ポート番号、および (エンドポイントの形式バイトによって指定されたときは) クライアントがこのエンドポイントでリモートオブジェクトへのソケット接続を生成するために使うRMIClientSocketFactoryオブジェクトの直列化表現で構成されます。エンドポイントの表現には、リモートオブジェクトのエクスポート時に指定されたRMIServerSocketFactoryオブジェクトは含まれません。
UnicastRef2型の参照を使って呼び出しが行われた場合、ランタイムは、指定されたリモートオブジェクトへの接続用ソケットの作成時に、エンドポイントのRMIClientSocketFactoryオブジェクトのcreateSocketメソッドを使います。また、ランタイムが特定のリモートオブジェクトに対して DGC「dirty」および「clean」呼び出しを実行する際に、リモート参照で指定されたのと同じRMIClientSocketFactoryオブジェクトから生成された接続を使って、リモート JVM 上の DGC を呼び出す必要があります。サーバ側の DGC 実装は、この処理が正しく行われたことを確認する必要があります。カスタムソケットファクトリを引数としてとらない
UnicastRemoteObject上の古いコンストラクタまたはメソッドを使ってエクスポートされたリモートオブジェクトでは、以前と同様に、UnicastRefおよびUnicastServerRef型のRemoteRefおよびServerRefが使われます。このようなオブジェクトには、エンドポイントの古いワイヤ表現である、UTF 形式のホスト文字列に続いてポート番号を指定する整数が使われます。これは、新しい 1.2 の機能を使わない RMI サーバが、以前のバージョンの RMI クライアントと相互運用を可能にするためです。
RMISocketFactory クラス
java.rmi.server.RMISocketFactoryabstract クラスは、トランスポートがソケットを取得する方法を指定するインタフェースを提供します。以下のクラスは、java.netパッケージのSocketおよびServerSocketを使用します。
package java.rmi.server;
public abstract class RMISocketFactory
implements RMIClientSocketFactory, RMIServerSocketFactory
{
public abstract Socket createSocket(String host, int port)
throws IOException;
public abstract ServerSocket createServerSocket(int port)
throws IOException;
public static void setSocketFactory(RMISocketFactory fac)
throws IOException {...}
public static RMISocketFactory getSocketFactory() {...}
public static void setFailureHandler(RMIFailureHandler fh) {...}
public static RMIFailureHandler getFailureHandler() {...}
}
static メソッドsetSocketFactoryは、RMI がソケットを取得するためのソケットファクトリを設定します。アプリケーションが自身のRMISocketFactoryのインスタンスのためにこのメソッドを呼び出せるのは 1 回だけです。アプリケーションの定義によるRMISocketFactoryの実装は、たとえば接続要求に対して事前にフィルタリングを行なって例外をスローするか、あるいはjava.net.Socketまたはjava.net.ServerSocketクラスの独自の拡張を返して、確実な通信チャネルを確保します。RMISocketFactoryを設定できるのは、実行中のセキュリティマネージャがソケットファクトリの設定を許可している場合だけであることに注意してください。 ソケットファクトリの設定が許可されていない場合には、SecurityExceptionがスローされます。static メソッド
getSocketFactoryは、RMI によって使用されるソケットファクトリを返します。ソケットファクトリが設定されていなければ、このメソッドはnullを返します。トランスポート層は、トランスポートでソケットの作成が必要になると、
getSocketFactoryメソッドが値を返したRMISocketFactory上でcreateSocketメソッドとcreateServerSocketメソッドを呼び出します。例を示します。
RMISocketFactory.getSocketFactory().createSocket(myhost, myport)
createSocketメソッドは、指定されたホストとポートに接続されるクライアントソケットを作成するものです。createServerSocketは、指定されたポート上にサーバソケットを作成するものです。デフォルトトランスポートにおける
RMISocketFactoryの実装は、次のように HTTP を使ってファイアウォールを通り抜ける透過性のある RMI を提供します。
setFailureHandlerメソッドは、サーバソケットの作成に失敗すると RMI ランタイムに呼び出されるように、失敗ハンドラを設定します。失敗用ハンドラはブール値を返して、リトライを行なってよいかどうかを示します。デフォルト の失敗用ハンドラはfalseを返し、デフォルト条件ではランタイムはソケット作成のリトライを行わないことを示します。
getFailureHandlerメソッドは、ソケット作成失敗に対応する現在のハンドラを返します。失敗用ハンドラが設定されていなければ、nullを返します。
RMIServerSocketFactory
インタフェース
RMIServerSocketFactory API
ドキュメントを参照してください。
RMIClientSocketFactory
インタフェース
RMIClientSocketFactory API
ドキュメントを参照してください。