org.omg.CosNaming

Interface NamingContextOperations

All Known Subinterfaces:

NamingContext ， NamingContextExt ， NamingContextExtOperations

所有已知实现类：

_NamingContextExtStub ， _NamingContextImplBase ， _NamingContextStub ， NamingContextExtPOA ， NamingContextPOA

public interface NamingContextOperations

命名上下文是一个包含一组名称绑定的对象，其中每个名称都是唯一的。 不同的名称可以在相同或不同的上下文中同时绑定到一个对象。

见CORBA COS Naming Specification.

方法摘要

Modifier and Type	Method and Description
void	bind_context(NameComponent[] n, NamingContext nc) 命名一个命名上下文的对象。
NamingContext	bind_new_context(NameComponent[] n) 此操作创建一个新的上下文并将其绑定到作为参数提供的名称。
void	bind(NameComponent[] n, Object obj) 在命名上下文中创建名称和对象的绑定。
void	destroy() 破坏操作会删除命名上下文。
void	list(int how_many, BindingListHolder bl, BindingIteratorHolder bi) 列表操作允许客户端在命名上下文中遍历一组绑定。
NamingContext	new_context() 此操作返回与调用操作的上下文相同的命名服务器实现的命名上下文。
void	rebind_context(NameComponent[] n, NamingContext nc) 在命名上下文中创建名称和命名上下文的绑定，即使名称已经在上下文中绑定了。
void	rebind(NameComponent[] n, Object obj) 即使名称已经在上下文中绑定，也可以在命名上下文中创建名称和对象的绑定。
Object	resolve(NameComponent[] n) 解析操作是在给定上下文中检索绑定到名称的对象的过程。
void	unbind(NameComponent[] n) 解除绑定操作会从上下文中删除名称绑定。

方法详细信息

bind

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

在命名上下文中创建名称和对象的绑定。 使用绑定绑定的命名上下文在传递化合物名称以解析时不参与名称解析。

参数

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 - 对象的名称

obj - 用给定名称重新绑定的对象

异常

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

解除绑定操作会从上下文中删除名称绑定。

参数

n - 对象的名称

异常

NotFound - 表示名称不标识绑定。

CannotProceed - 表示由于某些原因实现已经放弃了。 然而，客户端可能能够在返回的命名上下文中继续操作。

InvalidName - 表示名称无效。

list

void list(int how_many,
          BindingListHolder bl,
          BindingIteratorHolder bi)

列表操作允许客户端在命名上下文中遍历一组绑定。

列表操作在BindingList bl中最多返回所请求的绑定数量。

• 如果命名上下文包含其他绑定，则列表操作将返回具有附加绑定的BindingIterator。
• 如果命名上下文不包含其他绑定，则绑定迭代器是零对象引用。

参数

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

破坏操作会删除命名上下文。 如果命名上下文包含绑定，则引发NotEmpty异常。

异常

NotEmpty - 表示命名上下文包含绑定。