|
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 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 全部類別 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。