Java Remote Method Invocation: 5 - サーバインタフェース

Java Remote Method Invocation

5.8 RMI ソケットファクトリ

RMI ランタイム実装に、接続のために java.net.Socket および java.net.ServerSocket が必要な場合には、これらのクラスのオブジェクトを直接インスタンス化するのではなく、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 型の参照を使って呼び出しが行われた場合、ランタイムは��取馨�釈�釶辣就祁憶⊂次⑬�⑬昭��貴軒� 若閼緇厖瓶閭諷�痺�鴒鹿竢粤��クラス
java.rmi.server.RMISocketFactory abstract クラスは、トランスポートがソケットを取得する方法を指定するインタフェースを提供します。以下のクラスは、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 を提供します。

createSocket 上で、ファクトリは直接ソケットによる接続ができないホストに自動的に HTTP 接続を試みる

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

setFailureHandler メソッドは、サーバソケットの作成に失敗すると失敗用ハンドラを RMI ランタイムにより呼び出されるように設定します。失敗用ハンドラはブール値を返して、リトライを行なってよいかどうかを示します。デフォルトの失敗用ハンドラは false を返し、デフォルト条件ではランタイムはソケット作成のリトライを行わないことを示します。
getFailureHandler メソッドは、ソケット作成失敗の現在のハンドラを返し、失敗用ハンドラが設定されていなければ、null を返します。

5.8.2 RMIServerSocketFactory インタフェース

リモートオブジェクトとのカスタムの通信をサポートするには、エクスポート時にリモートオブジェクトに対して RMIServerSocketFactory のインスタンスを指定します。この場合、適切な UnicastRemoteObject コンストラクタか exportObject メソッド、または適切な java.rmi.activation.Activatable コンストラクタか exportObject メソッドを使用して実行します。このようなサーバソケットファクトリが、リモートオブジェクトとエクスポート時に関連付けられた場合、RMI ランタイムは、リモートクライアントからの接続を受け入れるために、リモートオブジェクトのサーバソケットファクトリを使って (RMIServerSocketFactory.createServerSocket メソッドを使用して) ServerSocket を作成します。
package java.rmi.server;
public interface RMIServerSocketFactory {

	public java.net.ServerSocket createServerSocket(int port)
		throws IOException;
}
5.8.3 RMIClientSocketFactory インタフェース

リモートオブジェクトとのカスタム通信をサポートするために、エクスポート時にリモートオブジェクトの RMIClientSocketFactory のインスタンスを指定できます。この場合、適切な UnicastRemoteObject コンストラクタか exportObject メソッド、または適切な java.rmi.activation.Activatable コンストラクタか exportObject メソッドによって行います。エクスポート時に、リモートオブジェクトにこのようなサーバソケットファクトリが関連付けられている場合、リモートオブジェクトに対するリモート参照とともにクライアントソケットファクトリがリモート Virtual Machine にダウンロードされます。 RMI ランタイムは、クライアントからリモートオブジェクトへの接続に、RMIClientSocketFactory.createSocket メソッドを使用します。
package java.rmi.server;
public interface RMIClientSocketFactory {
	public java.net.Socket createSocket(String host, int port)
		throws IOException;
}
目次 | 前の項目 | 次の項目
Copyright © 1997-1999 Sun Microsystems, Inc. All Rights Reserved.

5.8 RMI ソケットファクトリ

5.8.2 `RMIServerSocketFactory` インタフェース

5.8.3 `RMIClientSocketFactory` インタフェース

5.8 RMI ソケットファクトリ

5.8.2 RMIServerSocketFactory インタフェース

5.8.3 RMIClientSocketFactory インタフェース

5.8.2 `RMIServerSocketFactory` インタフェース

5.8.3 `RMIClientSocketFactory` インタフェース