compact3

javax.naming

Class LinkException

java.lang.Object

java.lang.Throwable

java.lang.Exception

javax.naming.NamingException

javax.naming.LinkException

All Implemented Interfaces:

Serializable

已知直接子类：

LinkLoopException ， MalformedLinkException

public class LinkException
extends NamingException

此异常用于描述解决链接时遇到的问题。 添加信息被添加到基本的NamingException以精确定位该链接的问题。

类似于NamingException如何捕获名称解析信息，LinkException捕获“链接”-name解析信息，以确定解决链接时遇到的问题。 所有这些字段可能为空。

• 链接已解析名称。 已解决的链接名称部分。
• 链接解决对象。 链接名称解析的对象。
• 链接剩余名称。 尚未解决的链接名称部分。
• 链接说明。 详细解释为什么链路分辨率失败。

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

从以下版本开始：

1.3

另请参见：

Context.lookupLink(javax.naming.Name) ， LinkRef ， Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	linkExplanation 包含为什么解决链接失败的例外。
protected Name	linkRemainingName 包含尚未解决的剩余链接名称。
protected Name	linkResolvedName 包含已成功解决的链接部分。
protected Object	linkResolvedObj 包含链接部分的分辨率成功的对象。

Fields inherited from class javax.naming.NamingException

remainingName, resolvedName, resolvedObj, rootException

构造方法摘要

构造方法

Constructor and Description
LinkException() 构造一个新的LinkException实例。
LinkException(String explanation) 构造具有解释的LinkException的新实例所有其他字段都初始化为null。

方法摘要

Modifier and Type	Method and Description
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) 生成此异常的字符串表示形式。

Methods inherited from class javax.naming.NamingException

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class 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 - 可能为空字符串，其中包含有关此异常的其他详细信息。

另请参见：

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()

检索分辨率成功的对象。 这是解决的链接名称被绑定到的对象。

结果

到目前为止已解决的可能为空的对象。 如果为空，则表示链接解析对象字段尚未设置。

另请参见：

getLinkResolvedName() ， setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()

在解析链接时检索与问题相关的说明。

结果

可能为空的详细字符串，解释解决链接问题的更多信息。 如果为空，则表示此异常没有链接详细信息。

另请参见：

setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)

设置解决链接时与问题遇到关联的说明。

参数

msg - 可能为空的详细字符串，解释更多关于解决链接的问题。 如果为空，则表示不会记录细节。

另请参见：

getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)

设置此异常的解决的链接名称字段。

name是一个复合名称。 如果要使用复合名称或字符串设置此字段，则必须“复制”复合名称，并使用字符串创建具有单个组件的组合名称。 然后可以使用生成的组合名称来调用此方法。

制作并存储name的副本。 随后的变化name不影响此NamingException，反之亦然副本。

参数

name - 将解析的链接名称设置为的名称。 这可以是null。 如果为空，则将链接解析的名称字段设置为null。

另请参见：

getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

设置此异常的剩余链接名称字段。

name是一个复合名称。 如果要使用复合名称或字符串设置此字段，则必须“复制”复合名称，并使用字符串创建具有单个组件的组合名称。 然后可以使用生成的组合名称来调用此方法。

制作并存储name的副本。 随后的变化name不影响此NamingException，反之亦然副本。

参数

name - 将剩余链接名称设置为的名称。 这可以是null。 如果为空，则将其余名称字段设置为null。

另请参见：

getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

设置此异常的链接解析对象字段。 这表示最后成功解析的链接名称对象。

参数

obj - 将链接解析对象设置为的对象。 这可以是null。 如果为null，链接解析对象字段设置为null。

另请参见：

getLinkResolvedObj()

toString

public String toString()

生成此异常的字符串表示形式。 该字符串由NamingException信息加上链接的剩余名称组成。 此字符串用于调试，而不是以编程方式解释。

重写：

toString在 NamingException

结果

此链接异常的非空字符串表示形式。

toString

public String toString(boolean detail)

生成此异常的字符串表示形式。 该字符串由NamingException信息加上解决链接的附加信息组成。 如果'detail'为真，则该字符串还包含有关链接解析对象的信息。 如果为false，则该方法与不接受参数的toString（）的形式相同。 此字符串用于调试，而不是以编程方式解释。

重写：

toString在 NamingException

参数

detail - 如果为true，请添加有关链接解析对象的信息。

结果

此链接异常的非空字符串表示形式。