モジュール java.rmi

パッケージ java.rmi.registry

クラスLocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry extends Object

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

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

導入されたバージョン:

1.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 - 参照を作成できなかった場合

導入されたバージョン:

1.1

getRegistry

public static Registry getRegistry(int port) throws RemoteException

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

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.1

getRegistry

public static Registry getRegistry(String host) throws RemoteException

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

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

1.1

getRegistry

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

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

パラメータ:

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

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

戻り値:

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

例外:

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

導入されたバージョン:

1.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 - レジストリをエクスポートできなかった場合

導入されたバージョン:

1.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