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