ErrorHandler

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

从以下版本开始：: SAX 1.0
另请参见：: XMLReader.setErrorHandler(org.xml.sax.ErrorHandler), SAXParseException

方法摘要
`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 Recommendation" 的 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 Recommendation" 的 1.2 节对“严重的错误”的定义。例如，解析器将使用此回调来报告违背了格式良好性的约束。

应用程序必须假定在解析器调用此方法之后该文档不可用，并且应该仅为收集更多的错误消息而继续进行：事实上，一旦调用了此方法，SAX 解析器就可以随意停止对其他任何事件的报告。

参数：: exception - 封装在 SAX 解析异常中的错误信息。
抛出：: SAXException - 任何 SAX 异常，可能包装另外的异常。
另请参见：: SAXParseException

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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