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 番ポートを使用し、指定されたホスト上で動作する、リモートオブジェクト Registry への参照を返します。
static Registry	getRegistry(String host, int port) 指定された port を使用し、指定されたホスト上で動作する、リモートオブジェクト Registry への参照を返します。
static Registry	getRegistry(String host, int port, RMIClientSocketFactory csf) 指定された port を使用し、指定されたホスト上で動作する、リモートオブジェクト 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 番ポートを使用し、指定されたホスト上で動作する、リモートオブジェクト Registry への参照を返します。host が null の場合は、ローカルホストが使用されます。

パラメータ:

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

戻り値:

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

例外:

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

導入されたバージョン:

JDK1.1

getRegistry

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

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

パラメータ:

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

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

戻り値:

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

例外:

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

導入されたバージョン:

JDK1.1

getRegistry

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

指定された port を使用し、指定されたホスト上で動作する、リモートオブジェクト 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 インスタンスと指定された port を引数に指定して static メソッド UnicastRemoteObject.exportObject を呼び出した場合と同様に、Registry インスタンスがエクスポートされます。ただし、この Registry インスタンスのエクスポートの場合、値 ObjID.REGISTRY_ID を使って構築された既知のオブジェクト識別子である ObjID インスタンスが使用される点が異なります。

パラメータ:

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

戻り値:

レジストリ

例外:

RemoteException - 参照をエクスポートできなかった場合

導入されたバージョン:

JDK1.1

createRegistry

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

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

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

パラメータ:

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

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

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

戻り値:

レジストリ

例外:

RemoteException - 参照をエクスポートできなかった場合

導入されたバージョン:

1.2