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

在命名上下文中创建一个名称和一个对象的绑定，即使名称已在上下文中绑定了。命名上下文绑定使用绑定不参与名称解析时的复合名字传递给被解决。

参数

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

解析操作是在一个给定的上下文中检索一个绑定到名称的对象的过程。给定的名称必须与绑定的名称完全匹配。命名服务不返回对象的类型。客户负责“缩小”对象到适当的类型。也就是说，客户端通常将返回的对象从对象投射到一个更专业的接口。

参数

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 -表明命名上下文包含绑定。