- 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捕获“link”-name解析信息,以确定解决链接时遇到的问题。 所有这些字段可能为null。
- 链接已解析名称。 已解决的链接名称部分。
- 链接解决对象。 链接名称解析的对象。
- 链接剩余名称。 尚未解决的链接名称部分。
- 链接说明。 详细解释为什么链接解析失败。
LinkException实例与并发多线程访问不同步。 尝试访问和修改单个LinkException实例的多个线程应锁定该对象。
- 从以下版本开始:
- 1.3
- 另请参见:
-
Context.lookupLink(javax.naming.Name)
,LinkRef
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 protected String
linkExplanation
包含为什么解决链接失败的例外。protected Name
linkRemainingName
包含尚未解决的剩余链接名称。protected Name
linkResolvedName
包含已成功解决的链接部分。protected Object
linkResolvedObj
包含链接部分的分辨率成功的对象。-
Fields inherited from class javax.naming.NamingException
remainingName, resolvedName, resolvedObj, rootException
-
-
构造方法摘要
构造方法 Constructor 描述 LinkException()
构造一个新的LinkException实例。LinkException(String explanation)
构造一个新的LinkException实例,并给出解释。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 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.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
字段详细信息
-
linkResolvedName
protected Name linkResolvedName
包含已成功解决的链接部分。 它是一个复合名称,可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
linkResolvedObj
protected Object linkResolvedObj
包含链接部分的分辨率成功的对象。 可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
linkRemainingName
protected Name linkRemainingName
包含尚未解决的剩余链接名称。 它是一个复合名称,可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
linkExplanation
protected String linkExplanation
包含为什么解决链接失败的例外。 可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
-
构造方法详细信息
-
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()
检索分辨率成功的对象。 这是解决的链接名称被绑定到的对象。- 结果
- 到目前为止已解决的可能为null的对象。 如果为空,则表示链接解析对象字段尚未设置。
- 另请参见:
-
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,请添加有关链接解析对象的信息。 - 结果
- 此链接异常的非空字符串表示形式。
-
-