javax.xml.transform
介面 ErrorListener

public interface ErrorListener

要提供自定義錯誤處理，則需實作此介面並使用 setErrorListener 方法註冊一個帶有 Transformer 的實作的實例。然後由 Transformer 通過此介面來報告所有錯誤和警告。

如果應用程序沒有 註冊自己的自定義 ErrorListener，則使用預設的 ErrorListener，它向 System.err 報告所有警告和錯誤，但不拋出任何 Exception。建議 應用程序註冊和使用 ErrorListener，以確保正確的警告和錯誤行為。

對於轉換錯誤，Transformer 必須使用此介面，而不是拋出 Exception：應用程序負責決定對於不同型別的錯誤和警告是否拋出 Exception。但要注意，在調用 fatalError(TransformerException exception) 後，不再需要對轉換使用 Transformer。

Transformer 可以使用此機制來報告 XML 分析錯誤和轉換錯誤。

方法摘要

void	error(TransformerException exception) 接收可恢復錯誤的通知。
void	fatalError(TransformerException exception) 接收不可恢復錯誤的通知。
void	warning(TransformerException exception) 接收警告通知。

方法詳細資訊

warning

void warning(TransformerException exception)
             throws TransformerException

接收警告通知。

Transformer 可以使用此方法來報告不是錯誤或致命錯誤的條件。預設行為是不採取動作。

調用此方法後，必須繼續對轉換使用 Transformer。應用程序應該仍有可能處理文檔，直到文檔結尾。

參數：

exception - transformer 異常中封裝的警告資訊。

拋出：

TransformerException - 如果應用程序選擇中止轉換。

另請參見：

TransformerException

error

void error(TransformerException exception)
           throws TransformerException

接收可恢復錯誤的通知。

調用此方法後，轉換器必須繼續嘗試並提供正常轉換。如果未遇到其他錯誤，應用程序應該仍有可能處理文檔，直到文檔結尾。

參數：

exception - transformer 異常中封裝的錯誤資訊。

拋出：

TransformerException - 如果應用程序選擇中止轉換。

另請參見：

TransformerException

fatalError

void fatalError(TransformerException exception)
                throws TransformerException

接收不可恢復錯誤的通知。

處理器可能會選擇繼續執行處理操作，但無法正常成功地完成處理。

如果不能處理錯誤，或者希望立即終止執行，則該方法應該拋出異常。伺服器不一定回應此請求。

參數：

exception - TransformerException 中封裝的錯誤資訊。

拋出：

TransformerException - 如果應用程序選擇中止轉換。

另請參見：

TransformerException