模块  java.naming
软件包  javax.naming

Class LinkException

  • 实现的所有接口
    Serializable
    已知直接子类:
    LinkLoopExceptionMalformedLinkException

    public class LinkException
    extends NamingException
    此异常用于描述解析链接时遇到的问题。 附加信息将添加到基本NamingException中,以查明链接问题。

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

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

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

    从以下版本开始:
    1.3
    另请参见:
    Context.lookupLink(javax.naming.Name)LinkRefSerialized 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信息和链接的剩余名称组成。 此字符串用于调试,而不是以编程方式解释。
        重写:
        toStringNamingException
        结果
        此链接异常的非null字符串表示形式。
      • toString

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