-
- 既知のすべてのサブインタフェース:
NamingContext
,NamingContextExt
,NamingContextExtOperations
- 既知のすべての実装クラス:
_NamingContextExtStub
,_NamingContextImplBase
,_NamingContextStub
,NamingContextExtPOA
,NamingContextPOA
public interface NamingContextOperations
ネーミング・コンテキストは、それぞれが一意の名前を持つ一連のネーム・バインディングを格納するオブジェクトです。 異なる名前を、同時に、同じコンテキストまたは異なるコンテキストでバインドできます。「CORBA COS Naming Specification」を参照してください。
-
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 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
- 名前が無効な場合。
-
-