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