compact3

javax.naming

Class NamingException

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 异常

这是Context和DirContext接口中的操作抛出的所有异常的超类。 故障的性质由子类名称描述。 此异常捕获精确定位操作失败的位置的信息，例如最后进行解析的位置。

• 已解决名称 已解决的部分名称。
• 已解决的对象。 名称分辨率的对象。
• 剩余名称 尚未解决的部分名称。
• 说明。 详细解释名称解析失败的原因。
• 根异常 导致此命名异常抛出的异常。

null是任何这些字段的可接受值。 当为空时，表示没有为该字段记录此类信息。

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

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

从以下版本开始：

1.3

另请参见：

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) 从“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

字段详细信息

resolvedName

protected Name resolvedName

包含成功解决的部分名称。 它是一个复合名称，可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。

另请参见：

getResolvedName() ， setResolvedName(javax.naming.Name)

resolvedObj

protected Object resolvedObj

包含名称部分的解析成功的对象。 可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。

另请参见：

getResolvedObj() ， setResolvedObj(java.lang.Object)

remainingName

protected Name remainingName

包含尚未解决的剩余名称。 它是一个复合名称，可以为null。 该字段由构造函数初始化。 您应该通过get，set，“append”方法访问和操作该字段。

另请参见：

getRemainingName() ， setRemainingName(javax.naming.Name) ， appendRemainingName(javax.naming.Name) ， appendRemainingComponent(java.lang.String)

rootException

protected Throwable rootException

包含导致此NamingException被抛出的原始异常。 如果存在可以从原始异常获得的附加信息，或者原始异常无法映射到NamingException的子类，则设置此字段。 可以为null。

该领域早于通用异常链接工具。 initCause(Throwable)和getCause()方法现在是访问此信息的首选方法。

另请参见：

getRootCause() ， setRootCause(Throwable) ， initCause(Throwable) ， getCause()

构造方法详细信息

NamingException

public NamingException(String explanation)

构造一个新的NamingException和解释。 所有未指定的字段都设置为null。

参数

explanation - 可能为空字符串，其中包含有关此异常的其他详细信息。

另请参见：

Throwable.getMessage()

NamingException

public NamingException()

构造一个新的NamingException。 所有字段都设置为null。

方法详细信息

getResolvedName

public Name getResolvedName()

检索已成功解决的名称的主要部分。

结果

已成功解决的部分名称。 它是一个复合名称。 它可以为null，这意味着已解析的名称字段尚未设置。

另请参见：

getResolvedObj() ， setResolvedName(javax.naming.Name)

getRemainingName

public Name getRemainingName()

检索其余未解决的名称部分。

结果

名称的一部分尚未解决。 它是一个复合名称。 它可以为null，这意味着剩余的名称字段尚未设置。

另请参见：

setRemainingName(javax.naming.Name) ， appendRemainingName(javax.naming.Name) ， appendRemainingComponent(java.lang.String)

getResolvedObj

public Object getResolvedObj()

检索分辨率成功的对象。 这是解析名称绑定到的对象。

结果

到目前为止已解决的可能为空的对象。 null表示已解析的对象字段尚未设置。

另请参见：

getResolvedName() ， setResolvedObj(java.lang.Object)

getExplanation

public String getExplanation()

检索与此异常相关的说明。

结果

可能为null的详细字符串，解释了有关此异常的更多信息。 如果为空，则表示没有此异常的详细消息。

另请参见：

Throwable.getMessage()

setResolvedName

public void setResolvedName(Name name)

设置此异常的已解析名称字段。

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

制作并存储name的副本。 随后的变化name不影响此NamingException，反之亦然副本。

参数

name - 将解析后的名称设置为可能为空的名称。 如果为空，则将已解析的名称字段设置为null。

另请参见：

getResolvedName()

setRemainingName

public void setRemainingName(Name name)

设置此异常的剩余名称字段。

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

制作并存储name的副本。 随后的变化name不影响此NamingException，反之亦然副本。

参数

name - 将剩余名称设置为可能为空的名称。 如果为空，则将其余名称字段设置为null。

另请参见：

getRemainingName() ， appendRemainingName(javax.naming.Name) ， appendRemainingComponent(java.lang.String)

setResolvedObj

public void setResolvedObj(Object obj)

设置此异常的已解析对象字段。

参数

obj - 将解析对象设置为可能为空的对象。 如果为空，则将已解析的对象字段设置为null。

另请参见：

getResolvedObj()

appendRemainingComponent

public void appendRemainingComponent(String name)

将名称添加为剩余名称中的最后一个组件。

参数

name - 要添加的组件。 如果name为null，则此方法不执行任何操作。

另请参见：

setRemainingName(javax.naming.Name) ， getRemainingName() ， appendRemainingName(javax.naming.Name)

appendRemainingName

public void appendRemainingName(Name name)

从“name”添加组件作为剩余名称中的最后一个组件。

name是一个复合名称。 如果意图附加复合名称，则应该“复制”复合名称，然后调用接受String参数的重载表单。

随后的变化name不影响剩余名称字段在此NamingException，反之亦然。

参数

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

另请参见：

setRemainingName(javax.naming.Name) ， getRemainingName() ， appendRemainingComponent(java.lang.String)

getRootCause

public Throwable getRootCause()

检索此NamingException的根本原因（如果有）。 当服务提供商想要向调用者指示非命名相关的异常时，使用命名异常的根本原因，但同时要使用NamingException结构来指示命名操作进行的距离。

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

结果

引起此命名异常的可能为空的异常。 如果为null，则表示没有为此命名异常设置根本原因。

另请参见：

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

返回此异常的原因。 原因是引发这个命名异常的可抛出。 如果原因不存在或未知，则返回null 。

重写：

getCause在类别 Throwable

结果

导致此异常的原因，或 null如果原因不存在或未知。

从以下版本开始：

1.4

另请参见：

initCause(Throwable)

initCause

public Throwable initCause(Throwable cause)

将此异常的原因初始化为指定的值。 原因是引发这个命名异常的可抛出。

最多可以调用此方法一次。

重写：

initCause在 Throwable

参数

cause - 原因，保存以供以后通过getCause()方法检索 。 A null值表示原因不存在或未知。

结果

引用这个 NamingException实例。

异常

IllegalArgumentException - 如果cause是这个例外。 （一个可以不是自己的事业）

IllegalStateException - 如果此方法已被调用此异常。

从以下版本开始：

1.4

另请参见：

getCause()

toString

public String toString()

生成此异常的字符串表示形式。 字符串表示由此异常的类名称，其详细消息以及如果它有根本原因，根本原因异常的字符串表示形式，后跟剩余的名称（如果它不为空）。 此字符串用于调试，而不是以编程方式解释。

重写：

toString在类别 Throwable

结果

包含此异常的字符串表示形式的非空字符串。

toString

public String toString(boolean detail)

更详细地生成字符串表示。 此字符串表示由不受参数的toString（）返回的信息，以及解析对象的字符串表示（如果不为空）组成。 此字符串用于调试，而不是以编程方式解释。

参数

detail - 如果为true，除了其他信息之外，还包括有关已解析对象的详细信息。

结果

包含字符串表示形式的非空字符串。