- 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 NameremainingName包含尚未解析的剩余名称。protected NameresolvedName包含已成功解析的名称部分。protected ObjectresolvedObj包含名称部分成功解析的对象。protected ThrowablerootException包含导致抛出此NamingException的原始异常。
-
构造方法摘要
构造方法 构造器 描述 NamingException()构造一个新的NamingException。NamingException(String explanation)构造一个带有解释的新NamingException。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 voidappendRemainingComponent(String name)添加名称作为剩余名称中的最后一个组件。voidappendRemainingName(Name name)添加“名称”中的组件作为剩余名称中的最后一个组件。ThrowablegetCause()返回此异常的原因。StringgetExplanation()检索与此异常关联的说明。NamegetRemainingName()检索名称的剩余未解决部分。NamegetResolvedName()检索已成功解析的名称的前导部分。ObjectgetResolvedObj()检索解析成功的对象。ThrowablegetRootCause()检索此NamingException的根本原因(如果有)。ThrowableinitCause(Throwable cause)将此异常的原因初始化为指定的值。voidsetRemainingName(Name name)设置此异常的剩余名称字段。voidsetResolvedName(Name name)设置此异常的已解析名称字段。voidsetResolvedObj(Object obj)设置此异常的已解析对象字段。voidsetRootCause(Throwable e)记录此NamingException的根本原因。StringtoString()生成此异常的字符串表示形式。StringtoString(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字符串。
-
-