javax.naming
類別 LinkException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.naming.NamingException
              javax.naming.LinkException

所有已實作的介面：

Serializable

直接已知子類別：

LinkLoopException, MalformedLinkException

public class LinkException
extends NamingException

此異常用於描述解析連接時遇到的問題。向基本 NamingException 添加補充資訊，用來指出該連接所具有的問題。

與 NamingException 捕獲名稱解析資訊的方式類似，LinkException 捕獲指出解析某一連接時所遇問題的“連接”名稱解析資訊。所有欄位都可以為 null。

• Link Resolved Name。已解析的連接名稱部分。
• Link Resolved Object。將要進行連接名稱解析的物件。
• Link Remaining Name。未解析的連接名稱部分。
• Link Explanation。解釋連接解析失敗原因的詳細資訊。

LinkException 實例與共時多執行緒存取不同步。試圖存取和修改單個 LinkException 實例的多個執行緒應該鎖定物件。

從以下版本開始：

1.3

另請參見：

Context.lookupLink(javax.naming.Name), LinkRef, 序列化表格

欄位摘要

protected String	linkExplanation 包含連接解析失敗原因的異常。
protected Name	linkRemainingName 包含尚未解析的剩餘連接名稱。
protected Name	linkResolvedName 包含已成功解析的連接部分。
protected Object	linkResolvedObj 包含一個物件，已成功解析的連接部分一直到達該物件。

從類別 javax.naming.NamingException 繼承的欄位

remainingName, resolvedName, resolvedObj, rootException

建構子摘要

LinkException()
建構一個新的 LinkException 實例。

LinkException(String explanation)
使用解釋建構一個新的 LinkException 實例，其他所有欄位都初始化為 null。

方法摘要

String	getLinkExplanation() 檢索與解析某一連接時遇到的問題關聯的解釋。
Name	getLinkRemainingName() 檢索連接名稱的剩餘未解析部分。
Name	getLinkResolvedName() 檢索成功被解析的連接名稱的開頭部分。
Object	getLinkResolvedObj() 檢索已成功解析成的物件。
void	setLinkExplanation(String msg) 設置與解析某一連接時所遇問題關聯的解釋。
void	setLinkRemainingName(Name name) 設置此異常的剩餘連接名稱欄位。
void	setLinkResolvedName(Name name) 設置此異常的已解析連接名稱欄位。
void	setLinkResolvedObj(Object obj) 設置此異常的已解析連接物件欄位。
String	toString() 產生此異常的字元串表示形式。
String	toString(boolean detail) 產生此異常的字元串表示形式。

從類別 javax.naming.NamingException 繼承的方法

appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause

從類別 java.lang.Throwable 繼承的方法

fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

欄位詳細資訊

linkResolvedName

protected Name linkResolvedName

包含已成功解析的連接部分。它可以是一個復合名稱，並且可以為 null。此欄位由建構子初始化。應該通過其 get 和 set 方法存取和操作此欄位。

另請參見：

getLinkResolvedName(), setLinkResolvedName(javax.naming.Name)

linkResolvedObj

protected Object linkResolvedObj

包含一個物件，已成功解析的連接部分一直到達該物件。可以為 null。此欄位由建構子初始化。應該通過其 get 和 set 方法存取和操作此欄位。

另請參見：

getLinkResolvedObj(), setLinkResolvedObj(java.lang.Object)

linkRemainingName

protected Name linkRemainingName

包含尚未解析的剩餘連接名稱。它可以是一個復合名稱，並且可以為 null。此欄位由建構子初始化。應該通過其 get 和 set 方法存取和操作此欄位。

另請參見：

getLinkRemainingName(), setLinkRemainingName(javax.naming.Name)

linkExplanation

protected String linkExplanation

包含連接解析失敗原因的異常。可以為 null。此欄位由建構子初始化。應該通過其 get 和 set 方法存取和操作此欄位。

另請參見：

getLinkExplanation(), setLinkExplanation(java.lang.String)

建構子詳細資訊

LinkException

public LinkException(String explanation)

使用解釋建構一個新的 LinkException 實例，其他所有欄位都初始化為 null。

參數：

explanation - 一個可能為 null 的字元串，包含有關此異常的附加詳細資訊。

另請參見：

Throwable.getMessage()

LinkException

public LinkException()

建構一個新的 LinkException 實例。所有與連接無關的和與連接有關的欄位都被初始化為 null。

方法詳細資訊

getLinkResolvedName

public Name getLinkResolvedName()

檢索成功被解析的連接名稱的開頭部分。

返回：

成功被解析的連接名稱部分。該名稱是一個復合名稱。它可以為 null，表示尚未設置已解析連接名稱欄位。

另請參見：

getLinkResolvedObj(), setLinkResolvedName(javax.naming.Name)

getLinkRemainingName

public Name getLinkRemainingName()

檢索連接名稱的剩餘未解析部分。

返回：

未被解析的連接名稱部分。該名稱是一個復合名稱。它可以為 null，表示尚未設置連接剩餘解析名稱欄位。

另請參見：

setLinkRemainingName(javax.naming.Name)

getLinkResolvedObj

public Object getLinkResolvedObj()

檢索已成功解析成的物件。該物件是已解析的連接名稱被綁定到的物件。

返回：

到目前為止已解析的可能為 null 的物件。如果為 null，則意味著尚未設置已解析連接物件欄位。

另請參見：

getLinkResolvedName(), setLinkResolvedObj(java.lang.Object)

getLinkExplanation

public String getLinkExplanation()

檢索與解析某一連接時遇到的問題關聯的解釋。

返回：

更詳細地解釋有關解析某一連接時所遇問題的可能為 null 的字元串。如果為 null，則意味著沒有此異常的連接細節訊息。

另請參見：

setLinkExplanation(java.lang.String)

setLinkExplanation

public void setLinkExplanation(String msg)

設置與解析某一連接時所遇問題關聯的解釋。

參數：

msg - 更詳細地解釋有關解析某一連接時所遇問題的可能為 null 的字元串。如果為 null，則意味著沒有記錄任何細節資訊。

另請參見：

getLinkExplanation()

setLinkResolvedName

public void setLinkResolvedName(Name name)

設置此異常的已解析連接名稱欄位。

name 是一個復合名稱。如果打算使用復合名稱或字元串設置此欄位，則必須將該復合名稱“字元串化”，並用使用該字元串的單個元件創建一個復合名稱。然後可以使用得到的復合名稱調用此方法。

創建並存儲 name 的副本。對 name 進行的後續更改不會影響此 NamingException 中的副本，反之亦然。

參數：

name - 用來設置已解析連接名稱的名稱。此值可以為 null。如果為 null，則將已解析連接名稱欄位設置為 null。

另請參見：

getLinkResolvedName()

setLinkRemainingName

public void setLinkRemainingName(Name name)

設置此異常的剩餘連接名稱欄位。

name 是一個復合名稱。如果打算使用復合名稱或字元串設置此欄位，則必須將該復合名稱“字元串化”，並用使用該字元串的單個元件創建一個復合名稱。然後可以使用得到的復合名稱調用此方法。

創建並存儲 name 的副本。對 name 進行的後續更改不會影響此 NamingException 中的副本，反之亦然。

參數：

name - 用來設置剩餘連接名稱的名稱。此值可以為 null。如果其為 null，則將剩餘的名稱欄位設置為 null。

另請參見：

getLinkRemainingName()

setLinkResolvedObj

public void setLinkResolvedObj(Object obj)

設置此異常的已解析連接物件欄位。此欄位指示最後一個成功解析的連接名稱物件。

參數：

obj - 用來設置已解析連接物件的物件。此值可以為 null。如果為 null，則將已解析連接物件欄位設置為 null。

另請參見：

getLinkResolvedObj()

toString

public String toString()

產生此異常的字元串表示形式。此字元串由 NamingException 資訊和連接的剩餘名稱組成。此字元串用於除錯，不以程式方式進行解釋。

覆寫：

類別 NamingException 中的 toString

返回：

此連接異常的非 null 字元串表示形式。

toString

public String toString(boolean detail)

產生此異常的字元串表示形式。此字元串由 NamingException 資訊和解析連接的附加資訊組成。如果 'detail' 為 true，則該字元串還包含有關已解析連接物件的資訊。如果為 false，則此方法在形式上與不接受任何參數的 toString() 方法相同。此字元串用於除錯，不以程式方式進行解釋。

覆寫：

類別 NamingException 中的 toString

參數：

detail - 如果為 true，則添加有關已解析連接物件的資訊。

返回：

此連接異常的非 null 字元串表示形式。