- 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接口中的操作抛出的所有异常的超类。 故障的性质由子类的名称描述。 此异常捕获精确定位操作失败的位置的信息,例如最后进行解析的位置。- 已解决名称 已经解决的部分名称。
- 已解决的对象。 名称分辨率的对象。
- 剩余名称 尚未解决的部分名称。
- 说明。 详细解释名称解析失败的原因。
- 根异常 导致此命名异常抛出的异常。
NamingException实例与并发多线程访问不同步。 尝试访问和修改单个NamingException实例的多个线程应锁定该对象。
这种异常已被改进以符合通用异常链接机制。 根异常 (或根本原因 )是与
Throwable.getCause()
方法返回的原因相同的对象。- 从以下版本开始:
- 1.3
- 另请参见:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field 描述 protected Name
remainingName
包含尚未解决的剩余名称。protected Name
resolvedName
包含成功解决的部分名称。protected Object
resolvedObj
包含名称部分的解析成功的对象。protected Throwable
rootException
包含导致此NamingException被抛出的原始异常。
-
构造方法摘要
构造方法 Constructor 描述 NamingException()
构造一个新的NamingException。NamingException(String explanation)
构造一个新的NamingException和解释。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 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.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace
-
-
-
-
字段详细信息
-
resolvedName
protected Name resolvedName
包含成功解决的部分名称。 它是一个复合名称,可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
resolvedObj
protected Object resolvedObj
包含名称部分的解析成功的对象。 可以为null。 该字段由构造函数初始化。 您应该通过get和set方法来访问和操作该字段。
-
remainingName
protected Name remainingName
包含尚未解决的剩余名称。 它是一个复合名称,可以为null。 该字段由构造函数初始化。 您应该通过get,set,“append”方法访问和操作该字段。
-
rootException
protected Throwable rootException
包含导致此NamingException被抛出的原始异常。 如果存在可以从原始异常获得的附加信息,或者原始异常无法映射到NamingException的子类,则设置此字段。 可以为null。该领域早于通用异常链接工具。
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的对象。 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()
方法稍后检索。 Anull
值表示原因不存在或未知。 - 结果
-
参考这个
NamingException
例子。 - 异常
-
IllegalArgumentException
- 如果cause
是这个例外。 (一个可以不是自己的事业) -
IllegalStateException
- 如果此方法已被调用此异常。 - 从以下版本开始:
- 1.4
- 另请参见:
-
getCause()
-
toString
public String toString()
生成此异常的字符串表示形式。 字符串表示由此异常的类名称,其详细消息以及如果它有根本原因,根本原因异常的字符串表示形式,后跟剩余的名称(如果它不为空)。 此字符串用于调试,而不是以编程方式解释。
-
toString
public String toString(boolean detail)
更详细地生成字符串表示。 此字符串表示由不受参数的toString()返回的信息,以及解析对象的字符串表示(如果不为空)组成。 此字符串用于调试,而不是以编程方式解释。- 参数
-
detail
- 如果为true,除了其他信息之外,还包括有关已解析对象的详细信息。 - 结果
- 包含字符串表示形式的非空字符串。
-
-