Module  java.xml
软件包  javax.xml.transform

Interface ErrorListener


  • public interface ErrorListener

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

    如果应用程序没有注册自己的自定义ErrorListener ，则使用默认ErrorListener ，报告所有警告和错误到System.err ，并且不会抛出任何异常 s。 强烈鼓励应用程序注册和使用ErrorListener ，以确保警告和错误的正确行为。

    对于转换错误， Transformer必须使用此接口，而不是抛出一个异常 ：由应用程序决定是否为不同类型的错误和警告抛出一个异常 。 不过请注意， Transformer不需要在调用fatalError(TransformerException exception)后继续进行转换。

    Transformer s可能会使用此机制来报告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