compact2, compact3

org.xml.sax

Interface ErrorHandler

所有已知实现类：

DefaultHandler ， DefaultHandler2 ， HandlerBase ， XMLFilterImpl

public interface ErrorHandler

SAX错误处理程序的基本界面。

This module, both source code and documentation, is in the Public Domain, and comes with NO WARRANTY. See http://www.saxproject.org for further information.

如果SAX应用程序需要实现自定义的错误处理，则必须实现此接口，然后使用setErrorHandler方法向XML读取器注册一个实例。 然后，解析器将通过此界面报告所有错误和警告。

警告：如果应用程序未注册ErrorHandler，XML解析错误将不会被报告，除非SAXParseException将抛出致命错误。 为了检测有效性错误，必须注册一个执行error()调用的ErrorHandler。

对于XML处理错误，SAX驱动程序必须使用此接口优先于引发异常：由应用程序决定是否针对不同类型的错误和警告抛出异常。 但是请注意，无需解析器在调用fatalError后继续报告其他错误。 换句话说，SAX驱动程序类可能会在报告任何fatalError之后引发异常。 解析器也可能为非XML错误抛出适当的异常。 例如， XMLReader.parse()将为访问实体或文档的错误抛出IOException。

从以下版本开始：

SAX 1.0

另请参见：

XMLReader.setErrorHandler(org.xml.sax.ErrorHandler) ， SAXParseException

方法摘要

Modifier and Type	Method and Description
void	error(SAXParseException exception) 接收可恢复错误的通知。
void	fatalError(SAXParseException exception) 接收不可恢复错误的通知。
void	warning(SAXParseException exception) 接收警告通知。

方法详细信息

warning

void warning(SAXParseException exception)
      throws SAXException

接收警告通知。

SAX解析器将使用此方法来报告XML推荐定义的不是错误或致命错误的条件。 默认行为是不采取任何行动。

调用此方法后，SAX解析器必须继续提供正常的解析事件：应用程序仍然可以将文档处理到最后。

过滤器也可以使用此方法来报告其他非XML警告。

参数

exception - 封装在SAX解析异常中的警告信息。

异常

SAXException - 任何SAX异常，可能包含另一个异常。

另请参见：

SAXParseException

error

void error(SAXParseException exception)
    throws SAXException

接收可恢复错误的通知。

这对应于W3C XML 1.0建议书第1.2节中“错误”的定义。 例如，验证解析器将使用此回调来报告违反有效性约束。 默认行为是不采取任何行动。

调用此方法后，SAX解析器必须继续提供正常的解析事件：应用程序仍然可以将文档处理到最后。 如果应用程序不能这样做，那么解析器应该报告一个致命错误，即使XML建议不需要这样做。

过滤器也可以使用此方法来报告其他非XML错误。

参数

exception - 封装在SAX解析异常中的错误信息。

异常

SAXException - 任何SAX异常，可能包装另一个异常。

另请参见：

SAXParseException

fatalError

void fatalError(SAXParseException exception)
         throws SAXException

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

该方法的文档和ContentHandler.endDocument()的文档之间存在明显的矛盾 。 在未来的主要版本解决之前，客户端不应该假设当解析器报告一个fatalError（）或抛出异常时是否会调用endDocument（）。

这对应于W3C XML 1.0建议书第1.2节中“致命错误”的定义。 例如，解析器将使用此回调来报告违反良好条件约束。

应用程序必须假设在解析器调用此方法后该文档不可用，并且应该继续（如果有的话），仅为了收集其他错误消息：实际上，SAX解析器可以在此之后自由停止报告任何其他事件方法已被调用。

参数

exception - 封装在SAX解析异常中的错误信息。

异常

SAXException - 任何SAX异常，可能包含另一个异常。

另请参见：

SAXParseException