JavaTM Platform
Standard Ed. 6

javax.naming
类 LinkRef

java.lang.Object
  继承者 javax.naming.Reference
      继承者 javax.naming.LinkRef
所有已实现的接口:
Serializable, Cloneable

public class LinkRef
extends Reference

此类表示一个 Reference,其内容是绑定到上下文中的原子名称的一个名称,称为链接名称 (link name)。

该名称是一个 URL,或者是一个将被相对于初始上下文解析的名称,如果该名称的第一个字符是 ".",则它相对于绑定该链接的上下文。

在上下文操作中,普通的名称解析总是根据链接进行的。解析链接名称本身可能导致该解析通过其他链接。这可能导致链接循环,该循环中的解析通常无法终止。有一个避免这类无法终止的解析的简单方法,即服务提供者可以定义一个关于调用者调用的任何单独操作中可以涉及的链接数的限制。

LinkRef 包含单个 StringRefAddr,其类型为 "LinkAddress",其内容则是一个链接名称。Reference 的类名称字段是此 (LinkRef) 类的类名称字段。

可使用标准的 Context.bind()/rebind() 和 DirContext.bind()/rebind() 将 LinkRef 绑定到一个名称。如果最终原子名称被绑定到某一链接,则使用 Context.lookupLink() 来检索该链接本身。

许多命名系统支持可在该命名系统本身中使用的本机链接概念。JNDI 不指定这类本机链接与 JNDI 链接之间是否存在任何关系。

LinkRef 实例与多个线程的并发访问不同步。需要并发地访问 LinkRef 的线程应该在它们之间实现同步并提供所需的锁定。

从以下版本开始:
1.3
另请参见:
LinkException, LinkLoopException, MalformedLinkException, Context.lookupLink(javax.naming.Name), 序列化表格

字段摘要
 
从类 javax.naming.Reference 继承的字段
addrs, classFactory, classFactoryLocation, className
 
构造方法摘要
LinkRef(Name linkName)
          为某一名称构造一个 LinkRef。
LinkRef(String linkName)
          为某一字符串名称构造一个 LinkRef。
 
方法摘要
 String getLinkName()
          检索此链接的名称。
 
从类 javax.naming.Reference 继承的方法
add, add, clear, clone, equals, get, get, getAll, getClassName, getFactoryClassLocation, getFactoryClassName, hashCode, remove, size, toString
 
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造方法详细信息

LinkRef

public LinkRef(Name linkName)
为某一名称构造一个 LinkRef。

参数:
linkName - 将为其创建此链接的非 null 名称。

LinkRef

public LinkRef(String linkName)
为某一字符串名称构造一个 LinkRef。

参数:
linkName - 将为其创建此链接的非 null 名称。
方法详细信息

getLinkName

public String getLinkName()
                   throws NamingException
检索此链接的名称。

返回:
此链接的非 null 名称。
抛出:
MalformedLinkException - 如果无法提取链接名称
NamingException - 如果遇到命名异常。

JavaTM Platform
Standard Ed. 6

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

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