Module  java.naming
软件包  javax.naming

Class LinkException

  • All Implemented Interfaces:
    Serializable
    已知直接子类:
    LinkLoopExceptionMalformedLinkException


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

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

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

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

    从以下版本开始:
    1.3
    另请参见:
    Context.lookupLink(javax.naming.Name)LinkRefSerialized Form
    • 构造方法详细信息

      • 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信息加上链接的剩余名称组成。 此字符串用于调试,而不是以编程方式解释。
        重写:
        toStringNamingException
        结果
        此链接异常的非空字符串表示形式。
      • toString

        public String toString​(boolean detail)
        生成此异常的字符串表示形式。 该字符串由NamingException信息加上解决链接的附加信息组成。 如果'detail'为真,则该字符串还包含有关链接解析对象的信息。 如果为false,则该方法与不接受参数的toString()的形式相同。 此字符串用于调试,而不是以编程方式解释。
        重写:
        toStringNamingException
        参数
        detail - 如果为true,请添加有关链接解析对象的信息。
        结果
        此链接异常的非空字符串表示形式。