public interface ErrorListener
| javax.xml.transform.ErrorListener |
要提供自定义错误处理，实现此接口并使用setErrorListener方法注册与执行的实例Transformer 。 然后， Transformer通过此界面报告所有错误和警告。
如果应用程序未注册自己的自定义ErrorListener ，则会使用默认的ErrorListener ，它ErrorListener所有警告和错误报告给System.err ，并且不会丢弃任何异常 。 强烈建议应用程序注册并使用ErrorListener ，以确保警告和错误的正确行为。
对于转换错误， Transformer必须使用此接口而不是抛出异常 ：由应用程序决定是否针对不同类型的错误和警告抛出异常 。 然而，需要注意的是Transformer不需要继续在通话结束后改造fatalError(TransformerException) 。
Transformer可能会使用此机制来报告XML解析错误以及转换错误。
公共方法(Public methods) |
|
|---|---|
abstract void |
error(TransformerException exception) 接收可恢复错误的通知。 |
abstract void |
fatalError(TransformerException exception) 接收不可恢复错误的通知。 |
abstract void |
warning(TransformerException exception) 接收警告通知。 |
void error (TransformerException exception)
接收可恢复错误的通知。
调用此方法后，变换器必须继续尝试并提供正常转换。 如果没有遇到其他错误，应用程序仍然可以处理文档。
| 参数(Parameters) | |
|---|---|
exception |
TransformerException: The error information encapsulated in a transformer exception. |
| 抛出异常(Throws) | |
|---|---|
TransformerException |
if the application chooses to discontinue the transformation. |
也可以看看：
void fatalError (TransformerException exception)
接收不可恢复错误的通知。
调用此方法后， Transformer必须继续尝试并提供正常转换。 如果没有遇到其他错误，应用程序仍然可以处理文档直到结束，但不能保证输出将可用。
| 参数(Parameters) | |
|---|---|
exception |
TransformerException: The error information encapsulated in a TransformerException. |
| 抛出异常(Throws) | |
|---|---|
TransformerException |
if the application chooses to discontinue the transformation. |
也可以看看：
void warning (TransformerException exception)
接收警告通知。
Transformer可以使用此方法报告非错误或致命错误的条件。 默认行为是不采取任何行动。
调用此方法后，Transformer必须继续进行转换。 应用程序仍然可以将文档处理到最后。
| 参数(Parameters) | |
|---|---|
exception |
TransformerException: The warning information encapsulated in a transformer exception. |
| 抛出异常(Throws) | |
|---|---|
TransformerException |
if the application chooses to discontinue the transformation. |
也可以看看：
Android开发手册