NamingException (Java Platform SE 8 )

java.lang.Object
- java.lang.Throwable
- - java.lang.Exception
  - - javax.naming.NamingException

All Implemented Interfaces:

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 异常
```
这是父类所有抛出的异常操作的上下文和DirContext接口。失败的性质描述由子类的名称来描述。这个异常捕获的信息精确定位操作失败，如在分辨率上进行。
- 解析名称。已解决的部分名称。
- 解决对象。名称的分辨率的对象。
- 剩下的名字。尚未解决的名称的一部分。
- 解释。详细解释为什么名称解析失败。
- 根异常。引发此命名异常的异常。
空是这些领域的任何一个可接受的值。当空时，它意味着没有这样的信息已被记录为该字段。
一个namingexception实例不同步的并发多线程访问。多个线程试图访问和修改一个namingexception实例应该锁定对象。

该异常已被更新以符合通用异常链机制。的根异常（或根本原因）是对象的Throwable.getCause()方法返回的原因相同。
从以下版本开始：

一点三

另请参见：

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected Name`	`remainingName` 包含尚未解决的剩余名称。
`protected Name`	`resolvedName` 包含已成功解决的名称的一部分。
`protected Object`	`resolvedObj` 包含名称的一部分的分辨率是成功的。
`protected Throwable`	`rootException` 包含着导致这namingexception被原来的异常。

构造方法摘要

构造方法
Constructor and Description
`NamingException()` 构建了一种新的namingexception。
`NamingException(String explanation)` 构建一个解释一个新的namingexception。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`appendRemainingComponent(String name)` 在剩余名称中添加名称作为最后一个组件。
`void`	`appendRemainingName(Name name)` 将“名称”中的组件添加到剩余名称中的最后一个组件。
`Throwable`	`getCause()` 返回此异常的原因。
`String`	`getExplanation()` 检索与此异常关联的解释。
`Name`	`getRemainingName()` 检索名称的剩余未解决部分。
`Name`	`getResolvedName()` 检索已成功解决的名称的领先部分。
`Object`	`getResolvedObj()` 检索分辨率为成功的对象。
`Throwable`	`getRootCause()` 检索此namingexception的根本原因，如果任何。
`Throwable`	`initCause(Throwable cause)` 初始化此异常原因为指定值。
`void`	`setRemainingName(Name name)` 设置此异常的剩余名称字段。
`void`	`setResolvedName(Name name)` 设置此异常的解析名称字段。
`void`	`setResolvedObj(Object obj)` 设置此异常的解决对象字段。
`void`	`setRootCause(Throwable e)` 记录这个namingexception根源。
`String`	`toString()` 生成此异常的字符串表示形式。
`String`	`toString(boolean detail)` 更详细的生成字符串表示形式。

Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - resolvedName
```
protected Name resolvedName
```
    包含已成功解决的名称的一部分。它是一个复合的名称，可以是空的。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。
    
    另请参见：
    
    getResolvedName()， setResolvedName(javax.naming.Name)
  - resolvedObj
```
protected Object resolvedObj
```
    包含名称的一部分的分辨率是成功的。可以为空。此字段由构造函数初始化。您应该通过它的获取和设置方法访问和操作这一字段。
    
    另请参见：
    
    getResolvedObj()， setResolvedObj(java.lang.Object)
  - remainingName
```
protected Name remainingName
```
    包含尚未解决的剩余名称。它是一个复合的名称，可以是空的。此字段由构造函数初始化。您应该通过它的获取、设置、“附加”方法访问和操作这一字段。
    
    另请参见：
    
    getRemainingName()， setRemainingName(javax.naming.Name)， appendRemainingName(javax.naming.Name)， appendRemainingComponent(java.lang.String)
  - rootException
```
protected Throwable rootException
```
    包含着导致这namingexception被原来的异常。这个字段设置如果有额外的信息可以从原来的异常，或者原有的异常不能被映射到一个类namingexception。可以为空。
    这场早于通用异常链设施。的initCause(Throwable)和getCause()方法现在访问这些信息的首选手段。
    
    另请参见：
    
    getRootCause()， setRootCause(Throwable)， initCause(Throwable)， getCause()
- Constructor Detail
  - NamingException
```
public NamingException(String explanation)
```
    构建一个解释一个新的namingexception。所有未指定的字段将被设置为空。
    
    参数
    
    explanation -可能为空的字符串包含更多的细节关于这个例外。
    
    另请参见：
    
    Throwable.getMessage()
  - NamingException
```
public NamingException()
```
    构建了一种新的namingexception。所有字段都设置为空。
- 方法详细信息
  - getResolvedName
```
public Name getResolvedName()
```
    检索已成功解决的名称的领先部分。
    
    结果
    
    成功解决的名称的一部分。它是一个复合名称。它可以是空的，这意味着解决的名称字段没有被设置。
    
    另请参见：
    
    getResolvedObj()， setResolvedName(javax.naming.Name)
  - getRemainingName
```
public Name getRemainingName()
```
    检索名称的剩余未解决部分。
    
    结果
    
    尚未解决的名称的一部分。它是一个复合名称。它可以是空的，这意味着剩余的名称字段没有被设置。
    
    另请参见：
    
    setRemainingName(javax.naming.Name)， appendRemainingName(javax.naming.Name)， appendRemainingComponent(java.lang.String)
  - getResolvedObj
```
public Object getResolvedObj()
```
    检索分辨率为成功的对象。这是解析的名称绑定的对象。
    
    结果
    
    到目前为止解决的可能为空的对象。无效意味着解析对象字段没有被设置。
    
    另请参见：
    
    getResolvedName()， setResolvedObj(java.lang.Object)
  - getExplanation
```
public String getExplanation()
```
    检索与此异常关联的解释。
    
    结果
    
    可能空的详细字符串解释了关于这个异常的更多。如果为空，则意味着没有这个异常的详细信息。
    
    另请参见：
    
    Throwable.getMessage()
  - setResolvedName
```
public void setResolvedName(Name name)
```
    设置此异常的解析名称字段。
    name是一个复合的名字。如果要使用一个复合名或字符串设置这个领域，你必须“stringify”复合的名字，并用字符串的单个组件创建一个复合的名字。然后，您可以使用所得到的复合名称调用此方法。
    
    一份name制造和储存。对name后续变化不影响复制本namingexception反之亦然。
    
    参数
    
    name -可能的空名设置解决的名字。如果为空，它将解析的名称字段设置为空。
    
    另请参见：
    
    getResolvedName()
  - setRemainingName
```
public void setRemainingName(Name name)
```
    设置此异常的剩余名称字段。
    name是一个复合的名字。如果要使用一个复合名或字符串设置这个领域，你必须“stringify”复合的名字，并用字符串的单个组件创建一个复合的名字。然后，您可以使用所得到的复合名称调用此方法。
    
    一份name制造和储存。对name后续变化不影响复制本namingexception反之亦然。
    
    参数
    
    name -可能的空名字把剩余的名字。如果为空，则将剩余的名称字段设置为空。
    
    另请参见：
    
    getRemainingName()， appendRemainingName(javax.naming.Name)， appendRemainingComponent(java.lang.String)
  - setResolvedObj
```
public void setResolvedObj(Object obj)
```
    设置此异常的解决对象字段。
    
    参数
    
    obj -设置解决对象可能的空对象。如果为空，则将解决的对象字段设置为空。
    
    另请参见：
    
    getResolvedObj()
  - appendRemainingComponent
```
public void appendRemainingComponent(String name)
```
    在剩余名称中添加名称作为最后一个组件。
    
    参数
    
    name -添加组件。如果名称为空，则此方法不做任何事情。
    
    另请参见：
    
    setRemainingName(javax.naming.Name)， getRemainingName()， appendRemainingName(javax.naming.Name)
  - appendRemainingName
```
public void appendRemainingName(Name name)
```
    将“名称”中的组件添加到剩余名称中的最后一个组件。
    name是一个复合的名字。如果要添加一个复合的名字，你应该“stringify”复合的名字然后调用重载的形式接受一个字符串参数。
    
    对name后续变化不影响其余名称字段在这namingexception反之亦然。
    
    参数
    
    name含有命令组件添加可能的空名。如果名称为空，则此方法不做任何事情。
    
    另请参见：
    
    setRemainingName(javax.naming.Name)， getRemainingName()， appendRemainingComponent(java.lang.String)
  - getRootCause
```
public Throwable getRootCause()
```
    检索此namingexception的根本原因，如果任何。一个命名异常的根本原因是当服务提供者希望显示来电者非命名相关的异常，但同时要用namingexception结构表明多远命名操作进行使用。
    这种方法在通用异常链设施。现在的getCause()方法获取这一信息的首选方式。
    
    结果
    
    导致这个命名异常的可能为空的异常。如果为空，则表示此命名异常没有任何根本原因。
    
    另请参见：
    
    setRootCause(java.lang.Throwable)， rootException， getCause()
  - setRootCause
```
public void setRootCause(Throwable e)
```
    记录这个namingexception根源。如果 e是 this，此方法不做任何事。
    这种方法在通用异常链设施。现在的initCause(Throwable)方法记录这些信息的首选手段。
    
    参数
    
    e -导致命名操作失败可能的空的例外。如果为空，则表示此命名异常没有根本原因。
    
    另请参见：
    
    getRootCause()， rootException， initCause(java.lang.Throwable)
  - getCause
```
public Throwable getCause()
```
    返回此异常的原因。原因是导致这一命名Throwable异常被抛出。返回 null如果原因是不存在的或未知的。
    
    重写：
    
    getCause 方法重写，继承类 Throwable
    
    结果
    
    此异常的原因，或 null如果原因是不存在的或未知的。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    initCause(Throwable)
  - initCause
```
public Throwable initCause(Throwable cause)
```
    初始化此异常原因为指定值。原因是导致这一命名Throwable异常被抛出。
    这种方法可以被称为在最一次。
    
    重写：
    
    initCause 方法重写，继承类 Throwable
    
    参数
    
    cause -的原因，这是以后的 getCause()方法检索。一个 null值表示的原因是不存在的或未知的。
    
    结果
    
    一提到这个 NamingException实例。
    
    异常
    
    IllegalArgumentException -如果 cause这是例外。（一个Throwable不能自己的原因。）
    
    IllegalStateException -如果这个方法已经被称为例外。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    getCause()
  - toString
```
public String toString()
```
    生成此异常的字符串表示形式。字符串表示由这个异常的类名称，它的详细信息，如果它有一个根本原因，根导致异常的字符串表示，然后由剩余的名称（如果它不是空）。该字符串用于调试和不可解释的程序。
    
    重写：
    
    toString 方法重写，继承类 Throwable
    
    结果
    
    包含此异常的字符串表示的非空字符串。
  - toString
```
public String toString(boolean detail)
```
    更详细的生成字符串表示形式。该字符串表示形式的信息，包括不带参数的tostring()回来，再加上字符串表示的解决对象（如果它不为空）。该字符串用于调试和不可解释的程序。
    
    参数
    
    detail -如果是真的，包括关于解决对象除了其他详细信息。
    
    结果
    
    包含字符串表示形式的非空字符串。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class NamingException

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Throwable

Methods inherited from class java.lang.Object

Field Detail

resolvedName

resolvedObj

remainingName

rootException

Constructor Detail

NamingException

NamingException

方法详细信息

getResolvedName

getRemainingName

getResolvedObj

getExplanation

setResolvedName

setRemainingName

setResolvedObj

appendRemainingComponent

appendRemainingName

getRootCause

setRootCause

getCause

initCause

toString

toString