javax.xml.transform
類別 TransformerException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.transform.TransformerException

所有已實作的介面：

Serializable

直接已知子類別：

TransformerConfigurationException

public class TransformerException
extends Exception

此類別指定了轉換過程中發生的異常條件。

另請參見：

序列化表格

建構子摘要

TransformerException(String message)
創建一個新的 TransformerException。

TransformerException(String message, SourceLocator locator)
從訊息和 Locator 創建一個新 TransformerException。

TransformerException(String message, SourceLocator locator, Throwable e)
包裹了 TransformerException 中的現有異常。

TransformerException(String message, Throwable e)
包裹 TransformerException 中的一個現有異常。

TransformerException(Throwable e)
創建一個套件裝了現有異常的新 TransformerException。

方法摘要

Throwable	getCause() 返回此拋出物件的原因，如果原因不存在或未知，則返回 null。
Throwable	getException() 此方法檢索此異常所包裹的異常。
String	getLocationAsString() 獲取字元串形式的位置資訊。
SourceLocator	getLocator() getLocator 方法檢索 SourceLocator 物件的實例，此物件指定了錯誤發生的位置。
String	getMessageAndLocation() 獲取帶有追加的位置資訊的錯誤訊息。
Throwable	initCause(Throwable cause) 將此拋出物件的原因 初始化為指定值。
void	printStackTrace() 列印從中產生錯誤的方法追蹤。
void	printStackTrace(PrintStream s) 列印從中產生錯誤的方法追蹤。
void	printStackTrace(PrintWriter s) 列印從中產生錯誤的方法追蹤。
void	setLocator(SourceLocator location) setLocator 方法設置 SourceLocator 物件的實例，此物件指定了錯誤發生的位置。

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

fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, setStackTrace, toString

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

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

建構子詳細資訊

TransformerException

public TransformerException(String message)

創建一個新的 TransformerException。

參數：

message - 錯誤或警告訊息。

TransformerException

public TransformerException(Throwable e)

創建一個套件裝了現有異常的新 TransformerException。

參數：

e - 要包裹的異常。

TransformerException

public TransformerException(String message,
                            Throwable e)

包裹 TransformerException 中的一個現有異常。

這用於在開始處理之前拋出處理器異常。

參數：

message - 錯誤或警告訊息，當要使用來自嵌入異常的訊息時為 null。

e - 任何異常

TransformerException

public TransformerException(String message,
                            SourceLocator locator)

從訊息和 Locator 創建一個新 TransformerException。

當應用程序從 DocumentHandler 回調中創建其自己的異常時，此建構子特別有用。

參數：

message - 錯誤或警告訊息。

locator - 錯誤或警告的定位符物件。

TransformerException

public TransformerException(String message,
                            SourceLocator locator,
                            Throwable e)

包裹了 TransformerException 中的現有異常。

參數：

message - 錯誤或警告訊息，當要使用來自嵌入異常的訊息時為 null。

locator - 錯誤或警告的定位符物件。

e - 任何異常

方法詳細資訊

getLocator

public SourceLocator getLocator()

getLocator 方法檢索 SourceLocator 物件的實例，此物件指定了錯誤發生的位置。

返回：

SourceLocator 物件，如果未指定，則返回 null。

setLocator

public void setLocator(SourceLocator location)

setLocator 方法設置 SourceLocator 物件的實例，此物件指定了錯誤發生的位置。

參數：

location - SourceLocator 物件，或為 null 以清除位置。

getException

public Throwable getException()

此方法檢索此異常所包裹的異常。

返回：

Throwable 物件，或返回 null。

另請參見：

getCause()

getCause

public Throwable getCause()

返回此拋出物件的原因，如果原因不存在或未知，則返回 null。（原因是拋出此拋出物件引起的拋出物件。）

覆寫：

類別 Throwable 中的 getCause

返回：

此 throwable 的 cause，如果 cause 不存在或是未知的，則返回 null。

initCause

public Throwable initCause(Throwable cause)

將此拋出物件的原因 初始化為指定值。（原因是拋出此拋出物件引起的拋出物件。）

此方法至多可以調用一次。此方法通常從建構子中調用，或者在創建拋出物件後立即調用。如果此拋出物件通過 TransformerException(Throwable) 或 TransformerException(String,Throwable) 創建，則此方法甚至一次也不能調用。

覆寫：

類別 Throwable 中的 initCause

參數：

cause - cause（保存此 cause，以便以後通過 getCause() 方法檢索它）。（允許 null 值，指出原因是不存在的或是未知的。）

返回：

對此 Throwable 實例的參考。

拋出：

IllegalArgumentException - 如果 cause 是此拋出物件。（拋出物件不能是它自己的原因。）

IllegalStateException - 如果此拋出物件通過 TransformerException(Throwable) 或 TransformerException(String,Throwable) 創建，或者此方法已經在此拋出物件上進行調用。

getMessageAndLocation

public String getMessageAndLocation()

獲取帶有追加的位置資訊的錯誤訊息。

返回：

表示帶有追加的位置資訊的錯誤訊息的 String。

getLocationAsString

public String getLocationAsString()

獲取字元串形式的位置資訊。

返回：

帶有位置資訊的字元串，如果沒有位置資訊，則返回 null。

printStackTrace

public void printStackTrace()

列印從中產生錯誤的方法追蹤。這將追蹤所有巢狀的異常物件，包括此物件。

覆寫：

類別 Throwable 中的 printStackTrace

printStackTrace

public void printStackTrace(PrintStream s)

列印從中產生錯誤的方法追蹤。這將追蹤所有巢狀的異常物件，包括此物件。

覆寫：

類別 Throwable 中的 printStackTrace

參數：

s - 將從中發送轉儲的串流。

printStackTrace

public void printStackTrace(PrintWriter s)

列印從中產生錯誤的方法追蹤。這將追蹤所有巢狀的異常物件，包括此物件。

覆寫：

類別 Throwable 中的 printStackTrace

參數：

s - 將從中發送轉儲的 writer。