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)
接收警告通知。
|
void warning(TransformerException exception) throws TransformerException
Transformer
可以使用此方法来报告不是错误或致命错误的条件。 默认行为是不采取任何行动。
调用此方法后,Transformer必须继续进行转换。 应用程序仍然可以将文档处理到最后。
exception
- 封装在变压器异常中的警告信息。
TransformerException
- 如果应用程序选择停止转换。
TransformerException
void error(TransformerException exception) throws TransformerException
在调用此方法后,变压器必须继续尝试并提供正常的转换。 如果没有遇到其他错误,应用程序仍然可以处理文档到最后。
exception
- 封装在变压器异常中的错误信息。
TransformerException
- 如果应用程序选择停止转换。
TransformerException
void fatalError(TransformerException exception) throws TransformerException
接收不可恢复错误的通知。
处理器可以选择继续,但通常不会继续完成。
如果方法无法处理错误,或者希望执行立即终止,该方法将抛出异常。 处理器不一定会符合这一要求。
exception
- 封装在TransformerException中的
TransformerException
。
TransformerException
- 如果应用程序选择中断转换。
TransformerException
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.