JavaTM 2 Platform
Std. Ed. v1.3

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 への参照を返します。hostnull の場合は、ローカルホストが使用されます。
パラメータ:
host - リモートレジストリのホスト
戻り値:
リモートオブジェクトレジストリへの参照 (スタブ)
例外:
RemoteException - 参照を作成できなかった場合
導入されたバージョン:
JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port)
                            throws RemoteException
指定された port を使用し、指定されたホスト上で動作する、リモートオブジェクト Registry への参照を返します。hostnull の場合は、ローカルホストが使用されます。
パラメータ:
host - リモートレジストリのホスト
port - レジストリが要求を受け付けるポート
戻り値:
リモートオブジェクトレジストリへの参照 (スタブ)
例外:
RemoteException - 参照を作成できなかった場合
導入されたバージョン:
JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port,
                                   RMIClientSocketFactory csf)
                            throws RemoteException
指定された port を使用し、指定されたホスト上で動作する、リモートオブジェクト Registry へのローカルに作成された参照を返します。このリモートレジストリとの通信には、渡された RMIClientSocketFactory csf を使用して、リモート hostport 上に 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

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.