模块  java.xml
软件包  javax.xml.transform

Interface ErrorListener


  • public interface ErrorListener

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

    如果应用程序注册自己的自定义ErrorListener ,则使用默认值ErrorListener将所有警告和错误报告给System.err ,并且不会丢弃任何异常 强烈建议应用程序注册并使用ErrorListener ,以确保警告和错误的正确行为。

    对于转换错误, Transformer必须使用此接口而不是抛出异常 :由应用程序决定是否针对不同类型的错误和警告抛出异常 然而,需要注意的是Transformer不需要继续在通话结束后改造fatalError(TransformerException exception)

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

    从以下版本开始:
    1.4
    • 方法详细信息

      • 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