JavaTM Platform
Standard Ed. 6

javax.naming
类 LinkException

java.lang.Object
  继承者 java.lang.Throwable
      继承者 java.lang.Exception
          继承者 javax.naming.NamingException
              继承者 javax.naming.LinkException
所有已实现的接口:
Serializable
直接已知子类:
LinkLoopException, MalformedLinkException

public class LinkException
     
extends NamingException

此异常用于描述解析链接时遇到的问题。向基本 NamingException 添加补充信息,用来指出该链接所具有的问题。

与 NamingException 捕获名称解析信息的方式类似,LinkException 捕获指出解析某一链接时所遇问题的“链接”名称解析信息。所有字段都可以为 null。

LinkException 实例与并发多线程访问不同步。试图访问和修改单个 LinkException 实例的多个线程应该锁定对象。

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

字段摘要
protected  String linkExplanation
          包含链接解析失败原因的异常。
protected  Name linkRemainingName
          包含尚未解析的剩余链接名称。
protected  Name linkResolvedName
          包含已成功解析的链接部分。
protected  Object linkResolvedObj
          包含一个对象,已成功解析的链接部分一直到达该对象。
 
从类 javax.naming.NamingException 继承的字段
remainingName, resolvedName, resolvedObj, rootException
 
构造方法摘要
LinkException()
          构造一个新的 LinkException 实例。
LinkException(String explanation)
          使用解释构造一个新的 LinkException 实例,其他所有字段都初始化为 null。
 
方法摘要
 String getLinkExplanation()
          检索与解析某一链接时遇到的问题关联的解释。
 Name getLinkRemainingName()
          检索链接名称的剩余未解析部分。
 Name getLinkResolvedName()
          检索成功被解析的链接名称的开头部分。
 Object getLinkResolvedObj()
          检索已成功解析成的对象。
 void setLinkExplanation(String msg)
          设置与解析某一链接时所遇问题关联的解释。
 void setLinkRemainingName(Name name)
          设置此异常的剩余链接名称字段。
 void setLinkResolvedName(Name name)
          设置此异常的已解析链接名称字段。
 void setLinkResolvedObj(Object obj)
          设置此异常的已解析链接对象字段。
 String toString()
          生成此异常的字符串表示形式。
 String toString(boolean detail)
          生成此异常的字符串表示形式。
 
从类 javax.naming.NamingException 继承的方法
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause
 
从类 java.lang.Throwable 继承的方法
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

linkResolvedName

protected Name linkResolvedName
包含已成功解析的链接部分。它可以是一个复合名称,并且可以为 null。此字段由构造方法初始化。应该通过其 get 和 set 方法访问和操作此字段。

另请参见:
getLinkResolvedName(), setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj
包含一个对象,已成功解析的链接部分一直到达该对象。可以为 null。此字段由构造方法初始化。应该通过其 get 和 set 方法访问和操作此字段。

另请参见:
getLinkResolvedObj(), setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name linkRemainingName
包含尚未解析的剩余链接名称。它可以是一个复合名称,并且可以为 null。此字段由构造方法初始化。应该通过其 get 和 set 方法访问和操作此字段。

另请参见:
getLinkRemainingName(), setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation
包含链接解析失败原因的异常。可以为 null。此字段由构造方法初始化。应该通过其 get 和 set 方法访问和操作此字段。

另请参见:
getLinkExplanation(), setLinkExplanation(java.lang.String)
构造方法详细信息

LinkException

public LinkException(String explanation)
使用解释构造一个新的 LinkException 实例,其他所有字段都初始化为 null。

参数:
explanation - 一个可能为 null 的字符串,包含有关此异常的附加详细信息。
另请参见:
Throwable.getMessage()

LinkException

public LinkException()
构造一个新的 LinkException 实例。所有与链接无关的和与链接有关的字段都被初始化为 null。

方法详细信息

getLinkResolvedName

public Name getLinkResolvedName()
检索成功被解析的链接名称的开头部分。

返回:
成功被解析的链接名称部分。该名称是一个复合名称。它可以为 null,表示尚未设置已解析链接名称字段。
另请参见:
getLinkResolvedObj(), setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()
检索链接名称的剩余未解析部分。

返回:
未被解析的链接名称部分。该名称是一个复合名称。它可以为 null,表示尚未设置链接剩余解析名称字段。
另请参见:
setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object getLinkResolvedObj()
检索已成功解析成的对象。该对象是已解析的链接名称被绑定到的对象。

返回:
到目前为止已解析的可能为 null 的对象。如果为 null,则意味着尚未设置已解析链接对象字段。
另请参见:
getLinkResolvedName(), setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()
检索与解析某一链接时遇到的问题关联的解释。

返回:
更详细地解释有关解析某一链接时所遇问题的可能为 null 的字符串。如果为 null,则意味着没有此异常的链接细节消息。
另请参见:
setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)
设置与解析某一链接时所遇问题关联的解释。

参数:
msg - 更详细地解释有关解析某一链接时所遇问题的可能为 null 的字符串。如果为 null,则意味着没有记录任何细节信息。
另请参见:
getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)
设置此异常的已解析链接名称字段。

name 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。

创建并存储 name 的副本。对 name 进行的后续更改不会影响此 NamingException 中的副本,反之亦然。

参数:
name - 用来设置已解析链接名称的名称。此值可以为 null。如果为 null,则将已解析链接名称字段设置为 null。
另请参见:
getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)
设置此异常的剩余链接名称字段。

name 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。

创建并存储 name 的副本。对 name 进行的后续更改不会影响此 NamingException 中的副本,反之亦然。

参数:
name - 用来设置剩余链接名称的名称。此值可以为 null。如果其为 null,则将剩余的名称字段设置为 null。
另请参见:
getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)
设置此异常的已解析链接对象字段。此字段指示最后一个成功解析的链接名称对象。

参数:
obj - 用来设置已解析链接对象的对象。此值可以为 null。如果为 null,则将已解析链接对象字段设置为 null。
另请参见:
getLinkResolvedObj()

toString

public String toString()
生成此异常的字符串表示形式。此字符串由 NamingException 信息和链接的剩余名称组成。此字符串用于调试,不以编程方式进行解释。

覆盖:
NamingException 中的 toString
返回:
此链接异常的非 null 字符串表示形式。

toString

public String toString(boolean detail)
生成此异常的字符串表示形式。此字符串由 NamingException 信息和解析链接的附加信息组成。如果 'detail' 为 true,则该字符串还包含有关已解析链接对象的信息。如果为 false,则此方法在形式上与不接受任何参数的 toString() 方法相同。此字符串用于调试,不以编程方式进行解释。

覆盖:
NamingException 中的 toString
参数:
detail - 如果为 true,则添加有关已解析链接对象的信息。
返回:
此链接异常的非 null 字符串表示形式。

JavaTM Platform
Standard Ed. 6

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

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