当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

_NamingContextExtStub (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

org.omg.CosNaming
类 _NamingContextExtStub

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      org.omg.CosNaming._NamingContextExtStub

所有已实现的接口：

Serializable, Object, IDLEntity, NamingContext, NamingContextExt, NamingContextExtOperations, NamingContextOperations

---

public class _NamingContextExtStub
extends ObjectImpl
implements NamingContextExt

NamingContextExt 是 NamingContext（它包含一组名称绑定，在这些名称绑定中，每个名称都是唯一的）的扩展，并且是互操作命名服务 (Interoperable Naming Service) 的一部分。可以同时将不同名称绑定到相同或不同上下文中的对象。通过 NamingContextExt，可以使用基于 URL 的名称进行绑定和解析。

请参阅 CORBA COS 命名规范。

另请参见：

序列化表格

---

构造方法摘要
_NamingContextExtStub()

 

方法摘要
String[]	_ids()           获得包含此 ObjectImpl 对象所支持的存储库标识符的字符串数组。
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)           列表操作允许客户端迭代命名上下文中的一组绑定。
NamingContext	new_context()           此操作返回调用该操作的上下文的命名服务器实现的命名上下文。
void	rebind_context(NameComponent[] n, NamingContext nc)           在命名上下文中创建名称和命名上下文的绑定，即使该名称已经绑定在上下文中。
void	rebind(NameComponent[] n, Object obj)           在命名上下文中创建名称和对象的绑定，即使该名称已经绑定在上下文中。
Object	resolve_str(String sn)           此操作将“字符串化的”名称解析为对象引用。
Object	resolve(NameComponent[] n)           解析操作是指检索绑定到给定上下文中名称的对象的过程。
NameComponent[]	to_name(String sn)           此操作将“字符串化的名称”转换为等效的“名称组件”数组。
String	to_string(NameComponent[] n)           此操作从 Name 组件数组创建字符串化的名称。
String	to_url(String addr, String sn)           此操作根据对象的“字符串化的名称”创建基于 URL 的 "iiopname://" 格式的名称。
void	unbind(NameComponent[] n)           unbind 操作从上下文移除名称绑定。

 

从类 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

 

从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

 

从接口 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

 

构造方法详细信息

_NamingContextExtStub

public _NamingContextExtStub()

方法详细信息

to_string

public String to_string(NameComponent[] n)
                 throws InvalidName

此操作从 Name 组件数组创建字符串化的名称。

指定者：

接口 NamingContextExtOperations 中的 to_string

参数：

n - 对象名

抛出：

org.omg.CosNaming.NamingContextExtPackage.InvalidName - 指示名称不标识绑定。

InvalidName

---

to_name

public NameComponent[] to_name(String sn)
                        throws InvalidName

此操作将“字符串化的名称”转换为等效的“名称组件”数组。

指定者：

接口 NamingContextExtOperations 中的 to_name

参数：

sn - 对象的“字符串化的名称”

抛出：

org.omg.CosNaming.NamingContextExtPackage.InvalidName - 指示名称不标识绑定。

InvalidName

---

to_url

public String to_url(String addr,
                     String sn)
              throws InvalidAddress,
                     InvalidName

此操作根据对象的“字符串化的名称”创建基于 URL 的 "iiopname://" 格式的名称。

指定者：

接口 NamingContextExtOperations 中的 to_url

参数：

addr - 运行“命名服务”的主机基于 Internet 的地址

sn - 对象的“字符串化的名称”

抛出：

org.omg.CosNaming.NamingContextExtPackage.InvalidName - 指示名称不标识绑定。

org.omg.CosNaming.NamingContextPackage.InvalidAddress - 指示主机基于 Internet 的地址不正确

InvalidAddress

InvalidName

---

resolve_str

public Object resolve_str(String sn)
                   throws NotFound,
                          CannotProceed,
                          InvalidName

此操作将“字符串化的”名称解析为对象引用。

指定者：

接口 NamingContextExtOperations 中的 resolve_str

参数：

sn - 对象的“字符串化的名称”

抛出：

NotFound - 指示不存在给定名称的对象引用。

CannotProceed - 指示给定的组合名称不正确

org.omg.CosNaming.NamingContextExtPackage.InvalidName - 指示名称不标识绑定。

InvalidName

---

bind

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

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

指定者：

接口 NamingContextOperations 中的 bind

参数：

n - 对象名

obj - 要与给定名称绑定在一起的对象

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

AlreadyBound - 指示已将对象绑定到指定名称。

---

bind_context

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

命名作为命名上下文的对象。在传递组合名称以进行解析时，使用 bind_context() 绑定的命名上下文参与名称解析。

指定者：

接口 NamingContextOperations 中的 bind_context

参数：

n - 对象名

nc - 要与给定名称绑定在一起的 NamingContect 对象

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

AlreadyBound - 指示已将对象绑定到指定名称。

---

rebind

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

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

指定者：

接口 NamingContextOperations 中的 rebind

参数：

n - 对象名

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

---

rebind_context

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

在命名上下文中创建名称和命名上下文的绑定，即使该名称已经绑定在上下文中。在传递组合名称以进行解析时，使用 rebind_context() 绑定的命名上下文参与名称解析。

指定者：

接口 NamingContextOperations 中的 rebind_context

参数：

n - 对象名

nc - 要与给定名称重新绑定在一起的 NamingContect 对象

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

---

resolve

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

解析操作是指检索绑定到给定上下文中名称的对象的过程。给定名称必须与绑定名称完全匹配。命名服务不返回对象的类型。客户端负责将对象“收缩”为适当的类型。即客户端通常将返回对象由 Object 强制转换为更专用的接口。

指定者：

接口 NamingContextOperations 中的 resolve

参数：

n - 对象名

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

---

unbind

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

unbind 操作从上下文移除名称绑定。

指定者：

接口 NamingContextOperations 中的 unbind

参数：

n - 对象名

抛出：

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

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

---

list

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

列表操作允许客户端迭代命名上下文中的一组绑定。

list 操作在 BindingList bl 中返回最多可以达到的请求绑定数。

• 如果命名上下文包含附加绑定，则 list 操作将返回带有附加绑定的 BindingIterator。
• 如果命名上下文不包含附加绑定，则绑定迭代器为 nil 对象引用。

指定者：

接口 NamingContextOperations 中的 list

参数：

how_many - 要返回的最大绑定数

bl - 返回的绑定列表

bi - 返回的绑定迭代器

---

new_context

public NamingContext new_context()

此操作返回调用该操作的上下文的命名服务器实现的命名上下文。没有将新上下文绑定到任何名称。

指定者：

接口 NamingContextOperations 中的 new_context

---

bind_new_context

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

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

指定者：

接口 NamingContextOperations 中的 bind_new_context

参数：

n - 对象名

抛出：

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

AlreadyBound - 指示已将对象绑定到指定名称。

CannotProceed - 指示由于某种原因放弃了实现。不过，客户端也可能在返回的命名上下文中继续该操作。

InvalidName - 指示名称无效。

---

destroy

public void destroy()
             throws NotEmpty

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

指定者：

接口 NamingContextOperations 中的 destroy

抛出：

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

---

_ids

public String[] _ids()

从类 ObjectImpl 复制的描述

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

指定者：

类 ObjectImpl 中的 _ids

返回：

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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM 2 Platform Standard Ed. 5.0
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。