- 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 异常
这是Context和DirContext接口中的操作抛出的所有异常的超类。 失败的性质由子类的名称描述。 此异常捕获精确定位操作失败位置的信息,例如最后进行分辨率的位置。- 已解决的名称。 已解决的名称部分。
- 已解决的对象。 进行名称解析的对象。
- 剩余名称。 尚未解析的名称部分。
- 说明。 细节解释为什么名称解析失败。
- 根例外。 引发此命名异常的异常。
NamingException实例未与并发多线程访问同步。 尝试访问和修改单个NamingException实例的多个线程应该锁定该对象。
此异常已经过改进,以符合通用异常链机制。 根异常 (或根本原因 )与
Throwable.getCause()
方法返回的原因相同。- 从以下版本开始:
- 1.3
- 另请参见:
- Serialized Form
-
-
字段汇总
字段 变量和类型 字段 描述 protected Name
remainingName
包含尚未解析的剩余名称。protected Name
resolvedName
包含已成功解析的名称部分。protected Object
resolvedObj
包含名称部分成功解析的对象。protected Throwable
rootException
包含导致抛出此NamingException的原始异常。
-
构造方法摘要
构造方法 构造器 描述 NamingException()
构造一个新的NamingException。NamingException(String explanation)
构造一个带有解释的新NamingException。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 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)
更详细地生成字符串表示。
-
-
-
字段详细信息
-
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
- 可能为null的字符串,包含有关此异常的其他详细信息。 - 另请参见:
-
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的详细信息字符串,用于解释有关此异常 如果为null,则表示此异常没有详细消息。
- 另请参见:
-
Throwable.getMessage()
-
setResolvedName
public void setResolvedName(Name name)
设置此异常的已解析名称字段。name
是复合名称。 如果目的是使用复合名称或字符串设置此字段,则必须“字符串化”复合名称,并使用字符串创建包含单个组件的复合名称。 然后,您可以使用生成的复合名称调用此方法。制作并存储
name
的副本。 对name
后续更改不会影响此NamingException中的副本,反之亦然。- 参数
-
name
- 用于将已解析名称设置为的可能为空的名称。 如果为null,则将已解析的名称字段设置为null。 - 另请参见:
-
getResolvedName()
-
setRemainingName
public void setRemainingName(Name name)
设置此异常的剩余名称字段。name
是复合名称。 如果目的是使用复合名称或字符串设置此字段,则必须“字符串化”复合名称,并使用字符串创建包含单个组件的复合名称。 然后,您可以使用生成的复合名称调用此方法。制作并存储
name
的副本。 对name
后续更改不会影响此NamingException中的副本,反之亦然。- 参数
-
name
- 可能为null的名称,用于将剩余名称设置为。 如果为null,则将剩余名称字段设置为null。 - 另请参见:
-
getRemainingName()
,appendRemainingName(javax.naming.Name)
,appendRemainingComponent(java.lang.String)
-
setResolvedObj
public void setResolvedObj(Object obj)
设置此异常的已解析对象字段。- 参数
-
obj
- 要将已解析对象设置为的可能为null的对象。 如果为null,则将已解析的对象字段设置为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
是复合名称。 如果意图是附加复合名称,则应该“stringify”复合名称,然后调用接受String参数的重载表单。对
name
后续更改不会影响此NamingException中的剩余名称字段,反之亦然。- 参数
-
name
- 包含要添加的有序组件的可能为null的名称。 如果name为null,则此方法不执行任何操作。 - 另请参见:
-
setRemainingName(javax.naming.Name)
,getRemainingName()
,appendRemainingComponent(java.lang.String)
-
getRootCause
public Throwable getRootCause()
检索此NamingException的根本原因(如果有)。 当服务提供者想要向调用者指示非命名相关的异常但同时想要使用NamingException结构来指示命名操作进行了多长时,就会使用命名异常的根本原因。此方法早于通用异常链设施。
getCause()
方法现在是获取此信息的首选方法。- 结果
- 导致此命名异常的可能为null的异常。 如果为null,则表示没有为此命名异常设置根本原因。
- 另请参见:
-
setRootCause(java.lang.Throwable)
,rootException
,getCause()
-
setRootCause
public void setRootCause(Throwable e)
- 参数
-
e
- 导致命名操作失败的可能为null的异常。 如果为null,则表示此命名异常没有根本原因。 - 另请参见:
-
getRootCause()
,rootException
,initCause(java.lang.Throwable)
-
getCause
public Throwable getCause()
返回此异常的原因。 原因是throwable导致抛出此命名异常。 如果原因不存在或未知,则返回null
。- 重写:
-
getCause
类Throwable
- 结果
-
此异常的原因,如果原因不存在或未知,
null
。 - 从以下版本开始:
- 1.4
- 另请参见:
-
initCause(Throwable)
-
initCause
public Throwable initCause(Throwable cause)
将此异常的原因初始化为指定的值。 原因是throwable导致抛出此命名异常。此方法最多可调用一次。
- 重写:
-
initCause
类Throwable
- 参数
-
cause
- 原因,保存以供以后通过getCause()
方法检索。null
值表示原因不存在或未知。 - 结果
-
对此
NamingException
实例的引用。 - 异常
-
IllegalArgumentException
- 如果cause
是此例外。 (抛弃不可能是它自己的原因。) -
IllegalStateException
- 如果已在此异常上调用此方法。 - 从以下版本开始:
- 1.4
- 另请参见:
-
getCause()
-
toString
public String toString()
生成此异常的字符串表示形式。 字符串表示由此异常的类名,其详细消息以及是否具有根本原因组成,根本原因异常的字符串表示形式,后跟剩余名称(如果它不为空)。 此字符串用于调试,而不是以编程方式解释。
-
toString
public String toString(boolean detail)
更详细地生成字符串表示。 此字符串表示形式由toString()返回的信息组成,该信息不带参数,加上已解析对象的字符串表示形式(如果它不为null)。 此字符串用于调试,而不是以编程方式解释。- 参数
-
detail
- 如果为true,除了其他信息外,还包括有关已解析对象的详细信息。 - 结果
- 包含字符串表示形式的非null字符串。
-
-