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

接收不可恢复错误的通知。

调用此方法后，Transformer 必须继续尝试并提供正常转换。如果未遇到其他错误，应用程序应该仍有可能处理文档，直到结尾，但不保证输出是可用的。

参数：

exception - TransformerException 中封装的错误信息。

抛出：

TransformerException - 如果应用程序选择中止转换。

另请参见：

TransformerException