-
public interface ErrorListener
要提供自定义错误处理,实现此接口并使用
setErrorListener
方法注册与执行的实例Transformer
。 然后,Transformer
通过此界面报告所有错误和警告。如果应用程序未注册自己的自定义
ErrorListener
,则使用默认值ErrorListener
将所有警告和错误报告给System.err
,并且不会丢弃任何异常
。 强烈建议应用程序注册并使用ErrorListener
,以确保警告和错误的正确行为。对于转换错误,
Transformer
必须使用此接口而不是抛出异常
:由应用程序决定是否针对不同类型的错误和警告抛出异常
。 然而,需要注意的是Transformer
不需要继续在通话结束后改造fatalError(TransformerException exception)
。Transformer
可以使用此机制来报告XML解析错误以及转换错误。- 从以下版本开始:
- 1.4
-
-
方法摘要
所有方法 实例方法 抽象方法 变量和类型 方法 描述 void
error(TransformerException exception)
接收可恢复错误的通知。void
fatalError(TransformerException exception)
接收不可恢复错误的通知。void
warning(TransformerException exception)
收到警告通知。
-
-
-
方法详细信息
-
warning
void warning(TransformerException exception) throws TransformerException
- 参数
-
exception
- 封装在变换器异常中的警告信息。 - 异常
-
TransformerException
- 如果应用程序选择停止转换。 - 另请参见:
-
TransformerException
-
error
void error(TransformerException exception) throws TransformerException
接收可恢复错误的通知。在调用此方法后,变换器必须继续尝试并提供正常转换。 如果没有遇到其他错误,应用程序仍然可以将文档处理到最后。
- 参数
-
exception
- 封装在转换器异常中的错误信息。 - 异常
-
TransformerException
- 如果应用程序选择停止转换。 - 另请参见:
-
TransformerException
-
fatalError
void fatalError(TransformerException exception) throws TransformerException
接收不可恢复错误的通知。
处理器可以选择继续,但通常不会成功完成。
如果该方法无法处理错误,或者希望执行立即终止,则该方法应抛出异常。 处理器不一定会遵守此请求。
- 参数
-
exception
- 封装在TransformerException
的错误信息。 - 异常
-
TransformerException
- 如果应用程序选择停止转换。 - 另请参见:
-
TransformerException
-
-