java.lang.Object
java.rmi.registry.LocateRegistry
public final class LocateRegistry extends Object
LocateRegistry
は、ローカル・ホストなどの特定のホスト上にある、ブートストラップ用リモート・オブジェクト・レジストリへの参照を取得したり、特定のポートで呼出しを受け入れるリモート・オブジェクト・レジストリを作成したりするために使用されます。
getRegistry
の呼出しは、リモート・ホストへの接続を実際に確立するわけではありません。 実際には、リモート・レジストリへのローカル参照が作成されるだけであり、これはリモート・ホスト上でレジストリが実行されていない場合でも行われます。 したがって、このメソッドによって返されたリモート・レジストリを呼び出す後続のメソッドは失敗する場合もあります。
- 導入されたバージョン:
- 1.1
- 関連項目:
-
メソッドのサマリー
修飾子と型メソッド説明static Registry
createRegistry
(int port) ローカル・ホスト上に、指定されたport
でリクエストを受け入れるRegistry
インスタンスを作成してエクスポートします。static Registry
createRegistry
(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) カスタム・ソケット・ファクトリを使用してそのインスタンスとの通信を行うRegistry
インスタンスを、ローカル・ホスト上で作成およびエクスポートします。static Registry
デフォルト・レジストリ・ポート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
への、ローカルに作成されたリモート参照を返します。
-
メソッドの詳細
-
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
-