Module java.naming
Package javax.naming

Class LinkException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
javax.naming.LinkException
所有已实现的接口:
Serializable
直接已知的子类:
LinkLoopException, MalformedLinkException
public class LinkException extends NamingException
该异常用于描述解析链接时遇到的问题。为了准确定位链接问题，基本的NamingException中添加了额外的信息。

类似于NamingException捕获名称解析信息，LinkException捕获“链接”名称解析信息，准确定位解析链接时遇到的问题。所有这些字段都可能为null。

  • 链接已解析名称。已解析的链接名称部分。
  • 链接已解析对象。链接名称解析进行中的对象。
  • 链接剩余名称。尚未解析的链接名称部分。
  • 链接解释。解释为何链接解析失败的详细信息。

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

自:
1.3
参见:

  • Field Details

  • Constructor Details

    • LinkException

      public LinkException(String explanation)
      带有解释构造LinkException的新实例。所有其他字段都初始化为null。
      参数:
      explanation - 可能为null的字符串，包含有关此异常的附加详细信息。
      参见:

    • LinkException

      public LinkException()
      构造LinkException的新实例。所有非链接相关和链接相关字段都初始化为null。

  • Method Details

    • getLinkResolvedName

      public Name getLinkResolvedName()
      检索成功解析的链接名称的前导部分。
      返回:
      已成功解析的链接名称部分。它是一个复合名称。它可以为null，这意味着链接已解析名称字段尚未设置。
      参见:

    • getLinkRemainingName

      public Name getLinkRemainingName()
      检索尚未解析的链接名称部分。
      返回:
      尚未解析的链接名称部分。它是一个复合名称。它可以为null，这意味着链接剩余名称字段尚未设置。
      参见:

    • getLinkResolvedObj

      public Object getLinkResolvedObj()
      检索解析成功的对象。这是已解析链接名称绑定的对象。
      返回:
      到目前为止已解析的可能为null的对象。如果为null，则表示链接已解析对象字段尚未设置。
      参见:

    • getLinkExplanation

      public String getLinkExplanation()
      检索解析链接时遇到的问题的解释。
      返回:
      可能为null的详细字符串，解释有关解析链接问题的更多信息。如果为null，则表示此异常没有链接详细消息。
      参见:

    • setLinkExplanation

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

    • setLinkResolvedName

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

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

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

      参数:
      name - 要设置已解析链接名称的名称。这可以为null。如果为null，则将链接已解析名称字段设置为null。
      参见:

    • setLinkRemainingName

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

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

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

      参数:
      name - 要设置剩余链接名称的名称。这可以为null。如果为null，则将剩余名称字段设置为null。
      参见:

    • setLinkResolvedObj

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

    • toString

      public String toString()
      生成此异常的字符串表示形式。此字符串包含NamingException信息以及链接的剩余名称。此字符串用于调试，不适合以编程方式解释。
      覆盖:
      toString 在类 NamingException
      返回:
      非null的此链接异常的字符串表示形式。

    • toString

      public String toString(boolean detail)
      生成此异常的字符串表示形式。此字符串由NamingException信息和解析链接的附加信息组成。如果'detail'为true，则字符串还包含有关已解析链接对象的信息。如果为false，则此方法与不接受参数的toString()形式相同。此字符串用于调试，不应被程序化地解释。
      覆盖：
      toString 在类 NamingException
      参数：
      detail - 如果为true，则添加有关已解析链接对象的信息。
      返回：
      此链接异常的非空字符串表示形式。