5.8 RMIソケット・ファクトリ

Java SEプラットフォームでは、リモート・オブジェクトとの通信にどのプロトコルを使うかについて、より柔軟にカスタマイズできるようにするため、新しいインタフェース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クライアントとの相互運用を可能にするためです。

ソケット・ファクトリを指定せずにリモート・オブジェクトをエクスポートするか、RMIClientSocketFactoryおよびRMIServerSocketFactory型のパラメータを含まないバージョンのUnicastRemoteObject.exportObjectメソッドまたはUnicastRemoteObjectコンストラクタを使用してリモート・オブジェクトをエクスポートした場合、JavaランタイムはシステムのデフォルトのRMIソケット・ファクトリを使用します。このソケット・ファクトリは、すべてのインタフェースで受信待機するソケットをワイルドカード・アドレスで開きます。その結果、リモート・オブジェクトはすべてのローカル・アドレスにエクスポートされます。リモート・オブジェクトを特定のアドレスにエクスポートするには、次のいずれかを行います。

• RMISocketFactory.setSocketFactoryメソッドを使用してソケット・ファクトリを指定します。
• RMIClientSocketFactoryおよびRMIServerSocketFactoryインタフェースを実装し、UnicastRemoteObject.exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)メソッドを呼び出します。または、UnicastRemoteObjectクラスをサブクラス化し、UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)コンストラクタを呼び出します。この方法は、異なるインタフェースにバインドされた異なるオブジェクトをエクスポートできる点で、RMISocketFactory.setSocketFactoryメソッドを呼び出す方法よりも柔軟性があります。ただし、この方法はより複雑です。RMIClientSocketFactory実装は、スタブに埋め込まれたインスタンスがクライアントに転送されるため、直列化可能である必要があります。RMIClientSocketFactory実装クラスは、クライアントからアクセス可能にする必要があります。そのためには、通常、これらのクラスが利用可能な場所をポイントするようにクライアントのRMIコードベースを構成します。
• いずれかのソケット・ファクトリを使用するかわりに、特定のインターネット・アドレスまたはドメインからの着信接続を受け入れるセキュリティ・ポリシーを設定します。このオプションは、特定のネットワーク、ドメインまたは特定のホスト(localhostのみを含む)にアクセスを制限できる点で、柔軟性があります。この方法を使用すると、JavaランタイムはシステムのデフォルトのRMIソケット・ファクトリを使用します。このソケット・ファクトリは、すべてのインタフェースで受信待機するソケットを開きます。このソケットは、許可されないホスト、ドメイン、ネットワークからの接続も受け入れますが、RMI要求を処理せずにただちにそれらの接続を閉じます。

5.8.1 RMISocketFactoryクラス

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メソッドgetSocketFactoryは、RMIによって使用されるソケット・ファクトリを返します。ソケット・ファクトリが設定されていなければ、このメソッドはnullを返します。

トランスポート層は、トランスポートでソケットの作成が必要になると、getSocketFactoryメソッドが値を返したRMISocketFactory上でcreateSocketとcreateServerSocketメソッドを呼び出します。例を示します。

    RMISocketFactory.getSocketFactory().createSocket(myhost, myport)

デフォルト・トランスポートにおけるRMISocketFactoryの実装は、次のようにHTTPを使ってファイアウォールを通り抜ける透過性のあるRMIを提供します。

• createSocket上で、ファクトリは直接ソケットによる接続ができないホストに自動的にHTTP接続を試みる。
• createServerSocket上で、ファクトリはサーバー・ソケットを返し、新しく受け付けられた接続がHTTP POST要求かを自動検出する。そうであれば、トランスポートへの要求の本体だけを透過的に伝え、出力をHTTP応答として整形する。

getFailureHandlerメソッドは、ソケット作成失敗の現在のハンドラを返し、失敗用ハンドラが設定されていなければ、nullを返します。

5.8.2 RMIServerSocketFactoryインタフェース

5.8.3 RMIClientSocketFactoryインタフェース