©
本文档使用 PHP中文网手册 发布
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.lang.Throwable java.lang.Exception javax.naming.NamingException
public class NamingException
此异常是 Context 和 DirContext 接口中的操作抛出的所有异常的超类。失败的特性由子类的名称描述。此异常捕获指出操作失败处的信息,比如解析最后进行到的位置。
NamingException 实例与并发多线程访问不同步。试图访问和修改单个 NamingException 实例的多个线程应该锁定对象。
此异常已作出改进,以符合通用异常链机制。根异常(或根 cause)是与 Throwable.getCause()
方法返回的 cause 相同的对象。
字段摘要 | |
---|---|
protected Name |
remainingName
包含尚未解析的剩余名称。 |
protected Name |
resolvedName
包含已成功解析的名称部分。 |
protected Object |
resolvedObj
包含一个对象,已成功解析的名称部分进行到该对象。 |
protected Throwable |
rootException
包含导致抛出此 NamingException 的原始异常。 |
构造方法摘要 | |
---|---|
NamingException()
构造一个新的 NamingException。 |
|
NamingException(String explanation)
使用解释构造一个新的 NamingException。 |
方法摘要 | |
---|---|
void |
appendRemainingComponent(String name)
将 name 作为剩余名称中最后的组件添加。 |
void |
appendRemainingName(Name name)
将 'name' 中的组件作为剩余名称中最后的组件添加。 |
Throwable |
getCause()
返回此异常的 cause。 |
String |
getExplanation()
检索与此异常关联的解释。 |
Name |
getRemainingName()
检索名称的剩余未解析部分。 |
Name |
getResolvedName()
检索成功被解析的名称的开头部分。 |
Object |
getResolvedObj()
检索已成功解析成的对象。 |
Throwable |
getRootCause()
检索此 NamingException 的根 cause,如果有的话。 |
Throwable |
initCause(Throwable cause)
将此异常的 cause 初始化为指定值。 |
void |
setRemainingName(Name name)
设置此异常的剩余名称字段。 |
void |
setResolvedName(Name name)
设置此异常的已解析名称字段。 |
void |
setResolvedObj(Object obj)
设置此异常的已解析对象字段。 |
void |
setRootCause(Throwable e)
记录此 NamingException 的根 cause。 |
String |
toString()
生成此异常的字符串表示形式。 |
String |
toString(boolean detail)
生成更详细的字符串表示形式。 |
从类 java.lang.Throwable 继承的方法 |
---|
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
protected Name resolvedName
getResolvedName()
,
setResolvedName(javax.naming.Name)
protected Object resolvedObj
getResolvedObj()
,
setResolvedObj(java.lang.Object)
protected Name remainingName
getRemainingName()
,
setRemainingName(javax.naming.Name)
,
appendRemainingName(javax.naming.Name)
,
appendRemainingComponent(java.lang.String)
protected Throwable rootException
此字段早于通用异常链设施。initCause(Throwable)
和 getCause()
方法现在是访问此信息的首选方法。
getRootCause()
,
setRootCause(Throwable)
,
initCause(Throwable)
,
getCause()
构造方法详细信息 |
---|
public NamingException(String explanation)
explanation
- 一个可能为 null 的字符串,包含有关此异常的附加详细信息。Throwable.getMessage()
public NamingException()
方法详细信息 |
---|
public Name getResolvedName()
getResolvedObj()
,
setResolvedName(javax.naming.Name)
public Name getRemainingName()
setRemainingName(javax.naming.Name)
,
appendRemainingName(javax.naming.Name)
,
appendRemainingComponent(java.lang.String)
public Object getResolvedObj()
getResolvedName()
,
setResolvedObj(java.lang.Object)
public String getExplanation()
Throwable.getMessage()
public void setResolvedName(Name name)
name 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。
创建并存储 name
的副本。对 name
进行的后续更改不会影响此 NamingException 中的副本,反之亦然。
name
- 用来设置已解析名称的名称(可能为 null)。如果其为 null,则将已解析名称字段设置为 null。getResolvedName()
public void setRemainingName(Name name)
name 是一个复合名称。如果打算使用复合名称或字符串设置此字段,则必须将该复合名称“字符串化”,并用使用该字符串的单个组件创建一个复合名称。然后可以使用得到的复合名称调用此方法。
创建并存储 name
的副本。对 name
进行的后续更改不会影响此 NamingException 中的副本,反之亦然。
name
- 用来设置剩余名称的名称(可能为 null)。如果其为 null,则将剩余的名称字段设置为 null。getRemainingName()
,
appendRemainingName(javax.naming.Name)
,
appendRemainingComponent(java.lang.String)
public void setResolvedObj(Object obj)
name
- 用来设置已解析对象的对象(可能为 null)。如果为 null,则将已解析对象字段设置为 null。getResolvedObj()
public void appendRemainingComponent(String name)
name
- 要添加的组件。如果 name 为 null,则此方法不执行任何操作。setRemainingName(javax.naming.Name)
,
getRemainingName()
,
appendRemainingName(javax.naming.Name)
public void appendRemainingName(Name name)
name 是一个复合名称。如果打算追加一个组合名称,则应该“字符串化”该组合名称,然后调用接受 String 参数的该方法的重载形式。
对 name
进行的后续更改不会影响此 NamingException 中的剩余名称字段,反之亦然。
name
- 要添加的包含有序组件的名称(可能为 null)。如果 name 为 null,则此方法不执行任何操作。setRemainingName(javax.naming.Name)
,
getRemainingName()
,
appendRemainingComponent(java.lang.String)
public Throwable getRootCause()
这是通用异常链设施之前的方法。getCause()
方法现在是获取此信息的首选方法。
setRootCause(java.lang.Throwable)
,
rootException
,
getCause()
public void setRootCause(Throwable e)
这是通用异常链设施之前的方法。initCause(Throwable)
方法现在是记录此信息的首选方法。
e
- 导致命名操作失败的异常(可能为 null)。如果为 null,则意味着此命名异常没有根 cause。getRootCause()
,
rootException
,
initCause(java.lang.Throwable)
public Throwable getCause()
null
。
Throwable
中的 getCause
null
。initCause(Throwable)
public Throwable initCause(Throwable cause)
此方法至多可以调用一次。
Throwable
中的 initCause
cause
- cause(保存此 cause,以便以后通过 getCause()
方法检索)。指示 cause 不存在或未知的 null 值。
NamingException
实例的引用。
IllegalArgumentException
- 如果 cause
是此异常。(throwable 对象不能是它自己的 cause。)
IllegalStateException
- 如果已经在此异常上调用此方法。getCause()
public String toString()
Throwable
中的 toString
public String toString(boolean detail)
detail
- 如果为 true,则除了包含其他信息外,还包含有关已解析对象的详细信息。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。