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捕捉“链接”的名称解析信息确定所遇到的问题，解决一个链接。所有这些字段可能是空的。

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

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

从以下版本开始：

一点三

另请参见：

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

Field Detail

linkResolvedName

protected Name linkResolvedName

包含已成功解决的链路的一部分。它是一个复合的名称，可以是空的。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。

另请参见：

getLinkResolvedName()， setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj

包含链接的部分的对象是成功的。可以为空。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。

另请参见：

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

linkRemainingName

protected Name linkRemainingName

包含尚未解决的剩余链接名称。它是一个复合的名称，可以是空的。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。

另请参见：

getLinkRemainingName()， setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation

包含链接失败的原因的异常。可以为空。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。

另请参见：

getLinkExplanation()， setLinkExplanation(java.lang.String)

Constructor Detail

LinkException

public LinkException(String explanation)

构建了LinkException的一个新实例的解释所有其他字段被初始化为null。

参数

explanation -可能为空的字符串包含更多的细节关于这个例外。

另请参见：

Throwable.getMessage()

LinkException

public LinkException()

构建了LinkException的一个新实例。所有非链接相关的和链接相关字段都被初始化为空。

方法详细信息

getLinkResolvedName

public Name getLinkResolvedName()

检索已成功解决的链接名称的引导部分。

结果

成功解决的链接名称的一部分。它是一个复合名称。它可以是空的，这意味着链接解决的名称字段没有被设置。

另请参见：

getLinkResolvedObj()， setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()

检索链接名称的剩余未解决部分。

结果

未解析的链接名称的一部分。它是一个复合名称。它可以是空的，这意味着链接的剩余名称字段没有被设置。

另请参见：

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是一个复合的名字。如果要使用一个复合名或字符串设置这个领域，你必须“stringify”复合的名字，并用字符串的单个组件创建一个复合的名字。然后，您可以使用所得到的复合名称调用此方法。

一份name制造和储存。对name后续变化不影响复制本namingexception反之亦然。

参数

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

另请参见：

getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

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

name是一个复合的名字。如果要使用一个复合名或字符串设置这个领域，你必须“stringify”复合的名字，并用字符串的单个组件创建一个复合的名字。然后，您可以使用所得到的复合名称调用此方法。

一份name制造和储存。对name后续变化不影响复制本namingexception反之亦然。

参数

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

另请参见：

getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

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

参数

obj -设置链接解决对象的对象。这可以是空的。如果为空，则将链路解决的对象字段设置为空。

另请参见：

getLinkResolvedObj()

toString

public String toString()

生成此异常的字符串表示形式。这个字符串组成的namingexception信息加链接的其余名称。该字符串用于调试和不可解释的程序。

重写：

toString 方法重写，继承类 NamingException

结果

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

toString

public String toString(boolean detail)

生成此异常的字符串表示形式。这个字符串组成的namingexception信息+解决环节的附加信息。如果“细节”是真的，字符串也包含了链接解决对象的信息。如果是错的，这种方法是作为tostring()接受没有参数的形式相同。该字符串用于调试和不可解释的程序。

重写：

toString 方法重写，继承类 NamingException

参数

detail -如果属实，添加链接信息解决对象。

结果

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