Java javax.naming 类 LinkException（JDK5）

135 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
extends NamingException

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

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

Link Resolved Name。已解析的链接名称部分。
Link Resolved Object。将要进行链接名称解析的对象。
Link Remaining Name。未解析的链接名称部分。
Link Explanation。解释链接解析失败原因的详细信息。

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)