-
- All Known Subinterfaces:
-
NamingContext
,NamingContextExt
,NamingContextExtOperations
- 所有已知实现类:
-
_NamingContextExtStub
,_NamingContextImplBase
,_NamingContextStub
,NamingContextExtPOA
,NamingContextPOA
public interface NamingContextOperations
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 void
bind(NameComponent[] n, Object obj)
在命名上下文中创建名称和对象的绑定。void
bind_context(NameComponent[] n, NamingContext nc)
命名一个命名上下文的对象。NamingContext
bind_new_context(NameComponent[] n)
此操作创建一个新的上下文并将其绑定到作为参数提供的名称。void
destroy()
破坏操作会删除命名上下文。void
list(int how_many, BindingListHolder bl, BindingIteratorHolder bi)
列表操作允许客户端在命名上下文中遍历一组绑定。NamingContext
new_context()
此操作返回与调用操作的上下文相同的命名服务器实现的命名上下文。void
rebind(NameComponent[] n, Object obj)
即使名称已经在上下文中绑定,也可以在命名上下文中创建名称和对象的绑定。void
rebind_context(NameComponent[] n, NamingContext nc)
在命名上下文中创建名称和命名上下文的绑定,即使名称已经在上下文中绑定了。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
- 表示该名称无效。
-
-