compact2, compact3

org.xml.sax

Interface ErrorHandler

所有已知实现类：

DefaultHandler， DefaultHandler2， HandlerBase， XMLFilterImpl

public interface ErrorHandler

萨克斯错误处理程序的基本界面。

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阅读器。解析器将通过这个接口报告所有的错误和警告。

警告：如果申请不登记的一个程序，XML解析错误会被报道，但saxparseexceptions将抛出致命错误。为了检测有效性错误，一个不error()电话必须注册ErrorHandler。

用于XML处理的错误，一个萨克斯驾驶员必须优先抛出异常使用此接口：它是由应用程序来决定是否要对不同类型的错误和警告的例外。注意，然而，这并没有要求，解析器继续打电话报告fatalError后附加误差。换句话说，一个萨克斯司机班可能抛出一个异常报告任何致命错误后。也可以把适当的非XML解析器错误异常。例如，XMLReader.parse()会把错误的文件访问的实体或一个IOException。

从以下版本开始：

萨克斯1

另请参见：

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 -萨克斯例外，可能是包装的另一个例外。

另请参见：

SAXParseException

error

void error(SAXParseException exception)
    throws SAXException

接收可恢复错误的通知。

这相当于在W3C XML 1推荐1.2节误差”的定义。例如，一个验证解析器将使用这个回调来报告一个有效性约束的违规行为。默认的行为是不采取行动。

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

筛选器可以使用此方法报告其他非XML错误以及。

参数

exception -错误信息封装在一个SAX解析异常。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

另请参见：

SAXParseException

fatalError

void fatalError(SAXParseException exception)
         throws SAXException

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

有一个明显的矛盾之间的文件这个方法和ContentHandler.endDocument()文档。直到这个模糊是未来的主要版本解决，客户不应该假设enddocument()是否会或不会被调用时，解析器报告了fatalerror()或抛出异常。

这相当于在W3C XML 1推荐1.2节致命错误”的定义。例如，一个解析器将使用该回调报告一性约束违反。

应用程序必须假设文件不可用在解释器调用这个方法，而应该继续（如果有的话）只为收集更多的错误信息的缘故：事实上，SAX解析器是自由停止报告任何其他事件一旦这个方法被调用。

参数

exception -错误信息封装在一个SAX解析异常。

异常

SAXException -萨克斯例外，可能是包装的另一个例外。

另请参见：

SAXParseException