JavaTM Platform
Standard Ed. 6

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 への参照を返します。hostnull の場合は、ローカルホストが使用されます。

パラメータ:
host - リモートレジストリのホスト
戻り値:
リモートオブジェクトレジストリへの参照 (スタブ)
例外:
RemoteException - 参照を作成できなかった場合
導入されたバージョン:
JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port)
                            throws RemoteException
指定された port を使用し、指定された host 上で動作する、リモートオブジェクト Registry への参照を返します。hostnull の場合は、ローカルホストが使用されます。

パラメータ:
host - リモートレジストリのホスト
port - レジストリが要求を受け付けるポート
戻り値:
リモートオブジェクトレジストリへの参照 (スタブ)
例外:
RemoteException - 参照を作成できなかった場合
導入されたバージョン:
JDK1.1

getRegistry

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

パラメータ:
host - リモートレジストリのホスト
port - レジストリが要求を受け付けるポート
csf - レジストリへの接続を確立するための 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

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。