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 を作成してエクスポートします。

パラメータ:

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

戻り値:

レジストリ

例外:

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

導入されたバージョン:

JDK1.1

createRegistry

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

ローカルホストに Registry を作成してエクスポートします。ローカルホストは、このレジストリとの通信にカスタムのソケットファクトリを使用します。作成されたレジストリは、渡された RMIServerSocketFactory によって作成された ServerSocket を使用して、指定された port で着信要求に待機します。このレジストリへの参照を受け取ったクライアントは、渡された RMIClientSocketFactory によって作成された Socket を使用します。

パラメータ:

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

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

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

戻り値:

レジストリ

例外:

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

導入されたバージョン:

1.2