org.omg.CosNaming

Class _NamingContextStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

org.omg.CosNaming._NamingContextStub

All Implemented Interfaces:

Serializable ， Object ， IDLEntity ， NamingContext ， NamingContextOperations

public class _NamingContextStub
extends ObjectImpl
implements NamingContext

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

见CORBA COS Naming Specification.

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
_NamingContextStub()

方法摘要

Modifier and Type	Method and Description
String[]	_ids() 检索包含此 ObjectImpl对象支持的存储库标识符的字符串数组。
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) 解除绑定操作会从上下文中删除名称绑定。

Methods inherited from class org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

构造方法详细信息

_NamingContextStub

public _NamingContextStub()

方法详细信息

bind

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

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

Specified by:

bind在接口 NamingContextOperations

参数

n - 对象的名称

obj - 与给定名称绑定的对象

异常

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

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

InvalidName - 表示该名称无效。

AlreadyBound - 表示一个对象已经绑定到指定的名称。

bind_context

public void bind_context(NameComponent[] n,
                         NamingContext nc)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound

命名一个命名上下文的对象。 使用bind_context（）绑定的命名上下文在传递化合物名称以进行解析时参与名称解析。

Specified by:

bind_context中的 NamingContextOperations

参数

n - 对象的名称

nc - 使用给定名称绑定的NamingContect对象

异常

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

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

InvalidName - 表示该名称无效。

AlreadyBound - 表示对象已经绑定到指定的名称。

rebind

public void rebind(NameComponent[] n,
                   Object obj)
            throws NotFound,
                   CannotProceed,
                   InvalidName

即使名称已经在上下文中绑定，也可以在命名上下文中创建名称和对象的绑定。 使用rebind绑定的命名上下文在传递化合物名称以进行解析时不参与名称解析。

Specified by:

rebind在界面 NamingContextOperations

参数

n - 对象的名称

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

异常

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

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

InvalidName - 表示该名称无效。

rebind_context

public void rebind_context(NameComponent[] n,
                           NamingContext nc)
                    throws NotFound,
                           CannotProceed,
                           InvalidName

在命名上下文中创建名称和命名上下文的绑定，即使名称已经在上下文中绑定了。 使用rebind_context（）绑定的命名上下文在传递化合物名称以进行解析时参与名称解析。

Specified by:

rebind_context在界面 NamingContextOperations

参数

n - 对象的名称

nc - 使用给定名称重命名的NamingContect对象

异常

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

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

InvalidName - 表示该名称无效。

resolve

public Object resolve(NameComponent[] n)
               throws NotFound,
                      CannotProceed,
                      InvalidName

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

Specified by:

resolve在界面 NamingContextOperations

参数

n - 对象的名称

异常

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

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

InvalidName - 表示该名称无效。

unbind

public void unbind(NameComponent[] n)
            throws NotFound,
                   CannotProceed,
                   InvalidName

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

Specified by:

unbind在界面 NamingContextOperations

参数

n - 对象的名称

异常

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

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

InvalidName - 表示该名称无效。

list

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

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

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

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

Specified by:

list在界面 NamingContextOperations

参数

how_many - 返回的绑定的最大数量

bl - 返回的绑定列表

bi - 返回的绑定迭代器

new_context

public NamingContext new_context()

此操作返回与调用操作的上下文相同的命名服务器实现的命名上下文。 新的上下文不限于任何名称。

Specified by:

new_context在界面 NamingContextOperations

bind_new_context

public NamingContext bind_new_context(NameComponent[] n)
                               throws NotFound,
                                      AlreadyBound,
                                      CannotProceed,
                                      InvalidName

此操作创建一个新的上下文并将其绑定到作为参数提供的名称。 新创建的上下文由与其绑定的上下文相同的命名服务器实现（即，实现由除了最后一个组件的名称参数表示的上下文的命名服务器）。

Specified by:

bind_new_context在界面 NamingContextOperations

参数

n - 对象的名称

异常

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

AlreadyBound - 表示一个对象已经绑定到指定的名称。

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

InvalidName - 表示该名称无效。

destroy

public void destroy()
             throws NotEmpty

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

Specified by:

destroy在界面 NamingContextOperations

异常

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

_ids

public String[] _ids()

描述从类别复制： ObjectImpl

检索包含此ObjectImpl对象支持的存储库标识符的字符串数组。 例如，对于stub，此方法返回有关stub支持的所有接口的信息。

Specified by:

_ids在 ObjectImpl

结果

该 ObjectImpl实例支持的所有存储库标识符的数组