モジュール java.corba
パッケージ org.omg.CosNaming

インタフェースNamingContextOperations

    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      void bind​(NameComponent[] n, Object obj)
      ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。
      void bind_context​(NameComponent[] n, NamingContext nc)
      ネーミング・コンテキストであるオブジェクトの名前を指定します。
      NamingContext bind_new_context​(NameComponent[] n)
      コンテキストを新しく作成し、引数として指定された名前にそのコンテキストをバインドします。
      void destroy​()
      destroyはネーミング・コンテキストを削除します。
      void list​(int how_many, BindingListHolder bl, BindingIteratorHolder bi)
      listを使用すると、クライアントはネーミング・コンテキスト内の一連のバインディングを次々に取得することができます。
      NamingContext new_context​()
      呼出し側のコンテキストと同じネーム・サーバーによって実装されるネーミング・コンテキストを返します。
      void rebind​(NameComponent[] n, Object obj)
      名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。
      void rebind_context​(NameComponent[] n, NamingContext nc)
      名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とネーミング・コンテキストのバインディングを作成します。
      Object resolve​(NameComponent[] n)
      resolveは、指定されたコンテキストで名前にバインドされているオブジェクトを取得します。
      void unbind​(NameComponent[] n)
      unbindは、コンテキストからネーム・バインディングを削除します。

    • メソッドの詳細

      • bind

        void bind​(NameComponent[] n,
          Object obj)
   throws NotFound,
          CannotProceed,
          InvalidName,
          AlreadyBound
        ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。 名前解決において複合名が渡された場合、bindを使用してバインドされているネーミング・コンテキストは、名前解決には加わりません。
        パラメータ:
        n - オブジェクトの名前
        obj - 指定された名前にバインドされるObject
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。
        AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合。

      • bind_context

        void bind_context​(NameComponent[] n,
                  NamingContext nc)
           throws NotFound,
                  CannotProceed,
                  InvalidName,
                  AlreadyBound
        ネーミング・コンテキストであるオブジェクトの名前を指定します。 名前解決において複合名が渡された場合、bind_context()を使用してバインドされているネーミング・コンテキストは、名前解決に加わります。
        パラメータ:
        n - オブジェクトの名前
        nc - 指定された名前にバインドされるNamingContectオブジェクト
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。
        AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合。

      • rebind

        void rebind​(NameComponent[] n,
            Object obj)
     throws NotFound,
            CannotProceed,
            InvalidName
        名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。 名前解決において複合名が渡された場合、rebindを使用してバインドされているネーミング・コンテキストは、名前解決に加わりません。
        パラメータ:
        n - オブジェクトの名前
        obj - 指定された名前に再バインドされるObject
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。

      • rebind_context

        void rebind_context​(NameComponent[] n,
                    NamingContext nc)
             throws NotFound,
                    CannotProceed,
                    InvalidName
        名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とネーミング・コンテキストのバインディングを作成します。 名前解決において複合名が渡された場合、rebind_context()を使用してバインドされているネーミング・コンテキストは名前解決に加わります。
        パラメータ:
        n - オブジェクトの名前
        nc - 指定された名前に再バインドされるNamingContectオブジェクト
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。

      • resolve

        Object resolve​(NameComponent[] n)
        throws NotFound,
               CannotProceed,
               InvalidName
        resolveは、指定されたコンテキストで名前にバインドされているオブジェクトを取得します。 指定された名前は、バインドされた名前と完全に一致している必要があります。 ネーム・サービスは、オブジェクトの型を返しません。 適切な型へのオブジェクトの「ナロー変換」は、クライアント側で行う必要があります。 つまり、通常クライアントは、Objectから返されたオブジェクトをより特殊化されたインタフェースにキャストします。
        パラメータ:
        n - オブジェクトの名前
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。

      • unbind

        void unbind​(NameComponent[] n)
     throws NotFound,
            CannotProceed,
            InvalidName
        unbindは、コンテキストからネーム・バインディングを削除します。
        パラメータ:
        n - オブジェクトの名前
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。

      • list

        void list​(int how_many,
          BindingListHolder bl,
          BindingIteratorHolder bi)
        listを使用すると、クライアントはネーミング・コンテキスト内の一連のバインディングを次々に取得することができます。

        listは、バインディング・リストbl内の、指定された数を最大数としてバインディングを返します。

        • ネーミング・コンテキストに余分なバインディングがある場合、listは余分なバインディングのバインディング・イテレータを返す。
        • ネーミング・コンテキストに余分なバインディングがない場合、バインディング・イテレータはnilのオブジェクト参照。
        パラメータ:
        how_many - 返されるバインディングの最大数
        bl - 返されるバインディングのリスト
        bi - 返されるバインディング・イテレータ

      • new_context

        NamingContext new_context​()
        呼出し側のコンテキストと同じネーム・サーバーによって実装されるネーミング・コンテキストを返します。 新しいコンテキストはどの名前にもバインドされていません。

      • bind_new_context

        NamingContext bind_new_context​(NameComponent[] n)
                        throws NotFound,
                               AlreadyBound,
                               CannotProceed,
                               InvalidName
        コンテキストを新しく作成し、引数として指定された名前にそのコンテキストをバインドします。 新しく作成されたコンテキストは、バインドされたコンテキストと同じネーム・サーバーによって実装されます。つまり、最後のコンポーネントを除いた、名前引数によって示されるコンテキストを実装するネーム・サーバーです。
        パラメータ:
        n - オブジェクトの名前
        例外:
        NotFound - 名前でバインディングが識別できない場合。
        AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合。
        CannotProceed - なんらかの理由により実装が中止された場合。 ただしクライアントは、返されたネーミング・コンテキストで処理を続行できる場合もある。
        InvalidName - 名前が無効な場合。

      • destroy

        void destroy​()
      throws NotEmpty
        destroyはネーミング・コンテキストを削除します。 ネーミング・コンテキストにバインディングがある場合は、NotEmpty例外がスローされます。
        例外:
        NotEmpty - Naming Contextにバインディングがある場合。