モジュール java.rmi
パッケージ 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への、ローカルに作成されたリモート参照を返します。

    • メソッドの詳細

      • 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