org.omg.CosNaming
介面 NamingContextOperations

所有已知子介面：

NamingContext, NamingContextExt, NamingContextExtOperations

所有已知實作類別：

_NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, NamingContextExtPOA, NamingContextPOA

public interface NamingContextOperations

命名上下文是包含一組名稱綁定的物件，在這些名稱綁定中，每個名稱都是唯一的。可以同時將不同名稱綁定到相同或不同上下文中的物件。

請參閱 CORBA COS 命名規範。

方法摘要

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) 解析操作是指檢索綁定到給定上下文中名稱的物件的過程。
void	unbind(NameComponent[] n) unbind 操作從上下文移除名稱綁定。

方法詳細資訊

bind

void bind(NameComponent[] n,
          Object obj)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound

在命名上下文中創建名稱和物件的綁定。在傳遞組合名稱以進行解析時，使用 bind 綁定的命名上下文不參與名稱解析。

參數：

n - 物件名

obj - 要與給定名稱綁定在一起的物件

拋出：

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 - 物件名

拋出：

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

解析操作是指檢索綁定到給定上下文中名稱的物件的過程。給定名稱必須與綁定名稱完全比對。命名服務不返回物件的型別。客戶端負責將物件“收縮”為適當的型別。即客戶端通常將返回物件由 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 操作在 BindingList bl 中返回最多可以達到的請求綁定數。

• 如果命名上下文包含附加綁定，則 list 操作將返回帶有附加綁定的 BindingIterator。
• 如果命名上下文不包含附加綁定，則綁定迭代器為 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 - 指示命名上下文包含綁定。