模块  java.naming
软件包  javax.naming

Class LinkException

  • 实现的所有接口
    Serializable
    已知直接子类：
    LinkLoopException ， MalformedLinkException 
    public class LinkException
extends NamingException
    此异常用于描述解析链接时遇到的问题。 附加信息将添加到基本NamingException中，以查明链接问题。

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

    • 链接已解析的名称。 已解析的链接名称部分。
    • 链接已解决的对象。 链接名称的解析继续进行的对象。
    • 链接剩余名称。 尚未解析的链接名称部分。
    • 链接说明。 细节解释链接解析失败的原因。

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

    从以下版本开始：
    1.3
    另请参见：
    Context.lookupLink(javax.naming.Name) ， LinkRef ， Serialized Form

    • 构造方法详细信息

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

      • getLinkExplanation

        public String getLinkExplanation()
        检索与解析链接时遇到的问题相关的说明。
        结果
        可能为null的详细信息字符串，解释有关解析链接问题的更多信息。 如果为null，则表示此异常没有链接详细信息。
        另请参见：
        setLinkExplanation(java.lang.String)

      • setLinkExplanation

        public void setLinkExplanation​(String msg)
        设置与解析链接时遇到的问题相关的说明。
        参数
        msg - 可能为null的详细信息字符串，解释有关解析链接问题的更多信息。 如果为null，则表示不会记录任何详细信息。
        另请参见：
        getLinkExplanation()

      • setLinkResolvedName

        public void setLinkResolvedName​(Name name)
        设置此异常的已解析链接名称字段。

        name是复合名称。 如果目的是使用复合名称或字符串设置此字段，则必须“字符串化”复合名称，并使用字符串创建包含单个组件的复合名称。 然后，您可以使用生成的复合名称调用此方法。

        制作并存储name的副本。 对name后续更改不会影响此NamingException中的副本，反之亦然。

        参数
        name - 将已解析的链接名称设置为的名称。 这可以为null。 如果为null，则将链接已解析的名称字段设置为null。
        另请参见：
        getLinkResolvedName()

      • setLinkRemainingName

        public void setLinkRemainingName​(Name name)
        设置此异常的剩余链接名称字段。

        name是复合名称。 如果目的是使用复合名称或字符串设置此字段，则必须“字符串化”复合名称，并使用字符串创建包含单个组件的复合名称。 然后，您可以使用生成的复合名称调用此方法。

        制作并存储name的副本。 对name后续更改不会影响此NamingException中的副本，反之亦然。

        参数
        name - 将剩余链接名称设置为的名称。 这可以为null。 如果为null，则将剩余名称字段设置为null。
        另请参见：
        getLinkRemainingName()

      • setLinkResolvedObj

        public void setLinkResolvedObj​(Object obj)
        设置此异常的链接已解析对象字段。 这表示最后一个成功解析的链接名称对象。
        参数
        obj - 要将链接已解析对象设置为的对象。 这可以为null。 如果为null，则将链接已解析对象字段设置为null。
        另请参见：
        getLinkResolvedObj()

      • toString

        public String toString()
        生成此异常的字符串表示形式。 此字符串由NamingException信息和链接的剩余名称组成。 此字符串用于调试，而不是以编程方式解释。
        重写：
        toString类 NamingException
        结果
        此链接异常的非null字符串表示形式。

      • toString

        public String toString​(boolean detail)
        生成此异常的字符串表示形式。 此字符串由NamingException信息以及解析链接的其他信息组成。 如果'detail'为true，则该字符串还包含有关链接已解析对象的信息。 如果为false，则此方法与不接受任何参数的toString（）形式相同。 此字符串用于调试，而不是以编程方式解释。
        重写：
        toString ，类 NamingException
        参数
        detail - 如果为true，则添加有关链接已解析对象的信息。
        结果
        此链接异常的非null字符串表示形式。