モジュール java.rmi
パッケージ java.rmi.registry

クラスLocateRegistry

java.lang.Object
java.rmi.registry.LocateRegistry
public final class LocateRegistry extends Object
LocateRegistryは、ローカル・ホストなどの特定のホスト上にある、ブートストラップ用リモート・オブジェクト・レジストリへの参照を取得したり、特定のポートで呼出しを受け入れるリモート・オブジェクト・レジストリを作成したりするために使用されます。

getRegistryの呼出しは、リモート・ホストへの接続を実際に確立するわけではありません。 実際には、リモート・レジストリへのローカル参照が作成されるだけであり、これはリモート・ホスト上でレジストリが実行されていない場合でも行われます。 したがって、このメソッドによって返されたリモート・レジストリを呼び出す後続のメソッドは失敗する場合もあります。

導入されたバージョン:
1.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 - 参照を作成できなかった場合
      導入されたバージョン:
      1.1

    • getRegistry

      public static Registry getRegistry​(int port) throws RemoteException
      指定されたportのローカル・ホストのリモート・オブジェクトRegistryへの参照を返します。
      パラメータ:
      port - レジストリがリクエストを受け入れるポート
      戻り値:
      リモート・オブジェクト・レジストリへの参照(スタブ)
      例外:
      RemoteException - 参照を作成できなかった場合
      導入されたバージョン:
      1.1

    • getRegistry

      public static Registry getRegistry​(String host) throws RemoteException
      デフォルト・レジストリ・ポートである1099番ポートを使用し、指定されたhost上で動作するリモート・オブジェクトRegistryへの参照を返します。 hostがnullの場合は、ローカル・ホストが使用されます。
      パラメータ:
      host - リモート・レジストリのホスト
      戻り値:
      リモート・オブジェクト・レジストリへの参照(スタブ)
      例外:
      RemoteException - 参照を作成できなかった場合
      導入されたバージョン:
      1.1

    • getRegistry

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