compact2, compact3

javax.xml.transform

Interface ErrorListener

public interface ErrorListener

要提供自定义错误处理，实现此接口并使用setErrorListener方法注册与该实现的实例Transformer 。 Transformer然后通过此界面报告所有错误和警告。

如果应用程序没有注册自己的定制ErrorListener ，默认ErrorListener使用哪个报告的所有警告和错误System.err并不会引发任何异常秒。 强烈鼓励应用程序注册和使用ErrorListener ，以确保警告和错误的正确行为。

对于转换错误， Transformer必须使用此接口，而不是投掷异常 ：由应用程序决定是否为不同类型的错误和警告抛出一个异常 。 但请注意， Transformer不需要在调用fatalError(TransformerException exception)后继续进行转换 。

Transformer可能会使用此机制来报告XML解析错误以及转换错误。

方法摘要

Modifier and Type	Method and Description
void	error(TransformerException exception) 接收可恢复错误的通知。
void	fatalError(TransformerException exception) 接收不可恢复错误的通知。
void	warning(TransformerException exception) 接收警告通知。

方法详细信息

warning

void warning(TransformerException exception)
      throws TransformerException

接收警告通知。

Transformer可以使用此方法来报告不是错误或致命错误的条件。 默认行为是不采取任何行动。

调用此方法后，Transformer必须继续进行转换。 应用程序仍然可以将文档处理到最后。

参数

exception - 封装在变压器异常中的警告信息。

异常

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

另请参见：

TransformerException

error

void error(TransformerException exception)
    throws TransformerException

接收可恢复错误的通知。

在调用此方法后，变压器必须继续尝试并提供正常的转换。 如果没有遇到其他错误，应用程序仍然可以处理文档到最后。

参数

exception - 封装在变压器异常中的错误信息。

异常

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

另请参见：

TransformerException

fatalError

void fatalError(TransformerException exception)
         throws TransformerException

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

处理器可以选择继续，但通常不会继续完成。

如果方法无法处理错误，或者希望执行立即终止，该方法将抛出异常。 处理器不一定会符合这一要求。

参数

exception - 封装在TransformerException中的 TransformerException 。

异常

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

另请参见：

TransformerException