JavaTM Platform
Standard Ed. 6

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

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

处理器可能会选择继续执行处理操作,但无法正常成功地完成处理。

如果不能处理错误,或者希望立即终止执行,则该方法应该抛出异常。服务器不一定响应此请求。

参数:
exception - TransformerException 中封装的错误信息。
抛出:
TransformerException - 如果应用程序选择中止转换。
另请参见:
TransformerException

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策