compact2、compact3

java.rmi.registry

クラスLocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry
extends Object

LocateRegistryは、ローカル・ホストなどの特定のホスト上にある、ブートストラップ用リモート・オブジェクト・レジストリへの参照を取得したり、特定のポートで呼出しを受け入れるリモート・オブジェクト・レジストリを作成したりするために使用されます。

getRegistryの呼出しは、リモート・ホストへの接続を実際に確立するわけではありません。実際には、リモート・レジストリへのローカル参照が作成されるだけであり、これはリモート・ホスト上でレジストリが実行されていない場合でも行われます。したがって、このメソッドによって返されたリモート・レジストリを呼び出す後続のメソッドは失敗する場合もあります。

導入されたバージョン:

JDK1.1

関連項目:

Registry

メソッドのサマリー

修飾子と型	メソッドと説明
static Registry	createRegistry(int port) ローカル・ホスト上に、指定されたportでリクエストを受け入れるRegistryインスタンスを作成してエクスポートします。
static Registry	createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) カスタム・ソケット・ファクトリを使用してそのインスタンスとの通信を行うRegistryインスタンスを、ローカル・ホスト上で作成およびエクスポートします。
static Registry	getRegistry() デフォルトのレジストリ・ポートである1099番ポートを使用するローカル・ホスト用のリモート・オブジェクトRegistryへの参照を返します。
static Registry	getRegistry(int port) 指定されたportを使用するローカル・ホスト用のリモート・オブジェクトRegistryへの参照を返します。
static Registry	getRegistry(String host) デフォルト・レジストリ・ポートである1099番ポートを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの参照を返します。
static Registry	getRegistry(String host, int port) 指定されたportを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの参照を返します。
static Registry	getRegistry(String host, int port, RMIClientSocketFactory csf) 指定されたportを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの、ローカルに作成されたリモート参照を返します。

クラス java.lang.Objectから継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

getRegistry

public static Registry getRegistry()
                            throws RemoteException

デフォルトのレジストリ・ポートである1099番ポートを使用するローカル・ホスト用のリモート・オブジェクトRegistryへの参照を返します。

戻り値:

リモート・オブジェクト・レジストリへの参照(スタブ)

例外:

RemoteException - 参照を作成できなかった場合

導入されたバージョン:

JDK1.1

getRegistry

public static Registry getRegistry(int port)
                            throws RemoteException

指定されたportを使用するローカル・ホスト用のリモート・オブジェクトRegistryへの参照を返します。

パラメータ:

port - レジストリがリクエストを受け入れるポート

戻り値:

リモート・オブジェクト・レジストリへの参照(スタブ)

例外:

RemoteException - 参照を作成できなかった場合

導入されたバージョン:

JDK1.1

getRegistry

public static Registry getRegistry(String host)
                            throws RemoteException

デフォルト・レジストリ・ポートである1099番ポートを使用し、指定されたhost上で動作する、リモート・オブジェクトRegistryへの参照を返します。hostがnullの場合は、ローカル・ホストが使用されます。

パラメータ:

host - リモート・レジストリのホスト

戻り値:

リモート・オブジェクト・レジストリへの参照(スタブ)

例外:

RemoteException - 参照を作成できなかった場合

導入されたバージョン:

JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port)
                            throws RemoteException

指定されたportを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの参照を返します。hostがnullの場合は、ローカル・ホストが使用されます。

パラメータ:

host - リモート・レジストリのホスト

port - レジストリがリクエストを受け入れるポート

戻り値:

リモート・オブジェクト・レジストリへの参照(スタブ)

例外:

RemoteException - 参照を作成できなかった場合

導入されたバージョン:

JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port,
                                   RMIClientSocketFactory csf)
                            throws RemoteException

指定されたportを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの、ローカルに作成されたリモート参照を返します。このリモート・レジストリとの通信には、指定されたRMIClientSocketFactory csfを使用して、リモートhostのport上にSocket接続を作成します。

パラメータ:

host - リモート・レジストリのホスト

port - レジストリがリクエストを受け入れるポート

csf - レジストリへの接続を確立するためのクライアント側Socketファクトリ。csfがnullの場合は、レジストリ・スタブ内でデフォルトのクライアント側Socketファクトリが使用される。

戻り値:

リモート・レジストリへの参照(スタブ)

例外:

RemoteException - 参照を作成できなかった場合

導入されたバージョン:

1.2

createRegistry

public static Registry createRegistry(int port)
                               throws RemoteException

ローカル・ホスト上に、指定されたportでリクエストを受け入れるRegistryインスタンスを作成してエクスポートします。

Registryインスタンスのエクスポートは、Registryインスタンスと指定されたportを引数として渡してstaticメソッドUnicastRemoteObject.exportObjectが呼び出されたかのように行われますが、ObjID.REGISTRY_IDの値で構築された既知のオブジェクト識別子であるObjIDインスタンスを使用してRegistryインスタンスがエクスポートされる点が異なります。

パラメータ:

port - レジストリが要求を受け入れるポート

戻り値:

レジストリ

例外:

RemoteException - レジストリをエクスポートできなかった場合

導入されたバージョン:

JDK1.1

createRegistry

public static Registry createRegistry(int port,
                                      RMIClientSocketFactory csf,
                                      RMIServerSocketFactory ssf)
                               throws RemoteException

カスタム・ソケット・ファクトリを使用してそのインスタンスとの通信を行うRegistryインスタンスを、ローカル・ホスト上で作成およびエクスポートします。作成されたレジストリは、指定されたport上で、指定されたRMIServerSocketFactoryから作成されたServerSocketを使って着信要求を待機します。

Registryインスタンスのエクスポートは、Registryインスタンス、指定されたport、指定されたRMIClientSocketFactoryおよび指定されたRMIServerSocketFactoryを引数として渡してstaticメソッドUnicastRemoteObject.exportObjectが呼び出されたかのように行われますが、ObjID.REGISTRY_IDの値で構築された既知のオブジェクト識別子であるObjIDインスタンスを使用してRegistryインスタンスがエクスポートされる点が異なります。

パラメータ:

port - レジストリがリクエストを受け入れるポート

csf - レジストリへの接続を確立するためのクライアント側Socketファクトリ

ssf - レジストリへの接続を受け入れるためのサーバー側ServerSocketファクトリ

戻り値:

レジストリ

例外:

RemoteException - レジストリをエクスポートできなかった場合

導入されたバージョン:

1.2