模块 java.naming
包 javax.naming

类 NamingException

java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.naming.NamingException
所有已实现的接口：
Serializable
已知子类：
AttributeInUseException , AttributeModificationException , CannotProceedException , CommunicationException , ConfigurationException , ContextNotEmptyException , InsufficientResourcesException , InterruptedNamingException , InvalidAttributeIdentifierException , InvalidAttributesException , InvalidAttributeValueException , InvalidNameException , InvalidSearchControlsException , InvalidSearchFilterException , LimitExceededException , LinkException , NameAlreadyBoundException , NameNotFoundException , NamingSecurityException , NoInitialContextException , NoSuchAttributeException , NotContextException , OperationNotSupportedException , PartialResultException , ReferralException , SchemaViolationException , ServiceUnavailableException
public class NamingException extends Exception
这是 Context 和 DirContext 接口中的操作抛出的所有异常的超类。故障的性质由子类的名称描述。此异常捕获精确定位操作失败位置的信息，例如上次进行解析的位置。
  • 解析名称。已解析的名称部分。
  • 已解决的对象。进行名称解析的对象。
  • 余名。尚未解析的名称部分。
  • 解释。详细解释名称解析失败的原因。
  • 根异常。导致抛出此命名异常的异常。
null 是任何这些字段的可接受值。为空时，表示该字段没有记录此类信息。

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

此异常已被改进以符合通用异常链接机制。这根异常（或者根本原因) 与原因由 Throwable.getCause() 方法返回。

自从：
1.3
参见：

  • 字段详细信息

  • 构造方法详细信息

    • NamingException

      public NamingException(String  explanation)
      构造一个带有解释的新 NamingException。所有未指定的字段都设置为空。
      参数：
      explanation - 一个可能为空的字符串，其中包含有关此异常的其他详细信息。
      参见：

    • NamingException

      public NamingException()
      构造一个新的 NamingException。所有字段都设置为空。

  • 方法详情

    • getResolvedName

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

    • getRemainingName

      public Name  getRemainingName()
      检索名称的剩余未解析部分。
      返回：
      尚未解析的名称部分。它是一个复合名称。可以为null，表示还没有设置剩余的name字段。
      参见：

    • getResolvedObj

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

    • getExplanation

      public String  getExplanation()
      检索与此异常关联的解释。
      返回：
      可能为空的详细信息字符串解释有关此异常的更多信息。如果为 null，则表示没有此异常的详细消息。
      参见：

    • setResolvedName

      public void setResolvedName(Name  name)
      设置此异常的解析名称字段。

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

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

      参数：
      name - 要设置解析名称的可能为空的名称。如果为空，它将解析的名称字段设置为空。
      参见：

    • setRemainingName

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

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

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

      参数：
      name - 将剩余名称设置为的可能为空的名称。如果为空，它将剩余的名称字段设置为空。
      参见：

    • setResolvedObj

      public void setResolvedObj(Object  obj)
      设置此异常的解析对象字段。
      参数：
      obj - 将已解析对象设置到的可能为 null 的对象。如果为空，则解析的对象字段设置为空。
      参见：

    • appendRemainingComponent

      public void appendRemainingComponent(String  name)
      添加名称作为剩余名称中的最后一个组件。
      参数：
      name - 要添加的组件。如果 name 为 null，则此方法不执行任何操作。
      参见：

    • appendRemainingName

      public void appendRemainingName(Name  name)
      添加来自“名称”的组件作为剩余名称中的最后一个组件。

      name 是复合名称。如果目的是附加一个复合名称，您应该将复合名称“字符串化”，然后调用接受 String 参数的重载形式。

      对 name 的后续更改不会影响此 NamingException 中的剩余名称字段，反之亦然。

      参数：
      name - 包含要添加的有序组件的可能为空的名称。如果 name 为 null，则此方法不执行任何操作。
      参见：

    • getRootCause

      public Throwable  getRootCause()
      检索此 NamingException 的根本原因（如果有）。当服务提供者想要向调用者指示一个非命名相关的异常但同时想要使用 NamingException 结构来指示命名操作进行到什么程度时，使用命名异常的根本原因。

      此方法早于通用异常链接工具。 getCause() 方法现在是获取此信息的首选方法。

      返回：
      导致此命名异常的可能为空的异常。如果为 null，则表示没有为此命名异常设置根本原因。
      参见：

    • setRootCause

      public void setRootCause(Throwable  e)
      记录此 NamingException 的根本原因。如果 e 是 this ，则此方法不执行任何操作。

      此方法早于通用异常链接工具。 initCause(Throwable) 方法现在是记录此信息的首选方法。

      参数：
      e - 导致命名操作失败的可能为空的异常。如果为 null，则表示此命名异常没有根本原因。
      参见：

    • getCause

      public Throwable  getCause()
      返回此异常的原因。原因是导致抛出此命名异常的 throwable。如果原因不存在或未知，则返回 null。
      重写：
      getCause 在类 Throwable 中
      返回：
      此异常的原因，或 null 如果原因不存在或未知。
      自从：
      1.4
      参见：

    • initCause

      public Throwable  initCause(Throwable  cause)
      将此异常的原因初始化为指定值。原因是导致抛出此命名异常的 throwable。

      此方法最多可调用一次。

      重写：
      initCause 在类 Throwable 中
      参数：
      cause - 原因，保存以供以后通过 getCause() 方法检索。 null 值表示原因不存在或未知。
      返回：
      对此 NamingException 实例的引用。
      抛出：
      IllegalArgumentException - 如果 cause 是这个异常。 （throwable 不能是它自己的原因。）
      IllegalStateException - 如果已针对此异常调用此方法。
      自从：
      1.4
      参见：

    • toString

      public String  toString()
      生成此异常的字符串表示形式。字符串表示形式包括此异常的类名、其详细消息，如果它有根本原因，则为根本原因异常的字符串表示形式，后跟其余名称（如果它不为空）。此字符串用于调试，并不意味着以编程方式进行解释。
      重写：
      toString 在类 Throwable 中
      返回：
      包含此异常的字符串表示形式的非空字符串。

    • toString

      public String  toString(boolean detail)
      更详细地生成字符串表示。此字符串表示形式由不带参数的 toString() 返回的信息以及已解析对象的字符串表示形式（如果它不为空）组成。此字符串用于调试，并不意味着以编程方式进行解释。
      参数：
      detail - 如果为真，除了其他信息外，还包括有关已解析对象的详细信息。
      返回：
      包含字符串表示形式的非空字符串。