org.omg.CosNaming

インタフェースNamingContextOperations

既知のすべてのサブインタフェース:

NamingContext, NamingContextExt, NamingContextExtOperations

既知のすべての実装クラス:

_NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, NamingContextExtPOA, NamingContextPOA

public interface NamingContextOperations

ネーミング・コンテキストは、それぞれが一意の名前を持つ一連のネーム・バインディングを格納するオブジェクトです。異なる名前を、同時に、同じコンテキストまたは異なるコンテキストでバインドできます。

「CORBA COS Naming Specification」を参照してください。

メソッドのサマリー

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