NamingContextOperations (Java Platform SE 7)

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

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 にバインディングがある場合。

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース NamingContextOperations

メソッドのサマリー

メソッドの詳細

bind

bind_context

rebind

rebind_context

resolve

unbind

list

new_context

bind_new_context

destroy