ValidatorHandler

ValidatorHandler

ValidatorHandler ()

派生类的构造函数。

构造函数什么都不做。

派生类必须创建包含 null ErrorHandler和 null LSResourceResolver ValidatorHandler对象。

getContentHandler

ContentHandler getContentHandler ()

获取接收到增强的验证结果的 ContentHandler 。

getErrorHandler

ErrorHandler getErrorHandler ()

获取当前 ErrorHandler设置为这个 ValidatorHandler 。

getFeature

boolean getFeature (String name)

查找功能标志的值。

功能名称是任何完全限定的URI。 ValidatorHandler可能会识别功能名称，但暂时无法返回其值。 某些功能值只能在特定上下文中使用，例如在验证之前，期间或之后。

实现者可以免费（并鼓励）使用构建在他们自己的URI上的名称来创建自己的特性。

getProperty

Object getProperty (String name)

查找一个属性的值。

属性名称是任何完全限定的URI。 ValidatorHandler可能会识别属性名称，但暂时无法返回其值。 某些属性值只能在特定的上下文中使用，例如在验证之前，期间或之后。

ValidatorHandler不需要识别任何特定的属性名称。

实现者可以免费（并鼓励）使用构建在他们自己的URI上的名称来创建他们自己的属性。

getResourceResolver

LSResourceResolver getResourceResolver ()

获取当前 LSResourceResolver设置为此 ValidatorHandler 。

getTypeInfoProvider

TypeInfoProvider getTypeInfoProvider ()

获得此 ValidatorHandler的 TypeInfoProvider实施。

可以在解析期间查询获得的 TypeInfoProvider以访问验证器确定的类型信息。

某些模式语言不定义类型的概念，对于这些语言，可能不支持此方法。 但是，要符合此规范，W3C XML Schema 1.0的实现必须支持此操作。

setContentHandler

void setContentHandler (ContentHandler receiver)

设置接收到增强的验证结果的 ContentHandler 。

当 ContentHandler指定，一个 ValidatorHandler将作为过滤器和基本输入事件复制到指定 ContentHandler 。

这样做， ValidatorHandler可以修改事件，例如添加默认属性。

一个 ValidatorHandler可能在某种程度上缓冲事件，但为了允许 ValidatorHandler被解析器使用，必须满足以下要求。

1. When startElement(String, String, String, Attributes), endElement(String, String, String), startDocument(), or endDocument() are invoked on a ValidatorHandler, the same method on the user-specified ContentHandler must be invoked for the same event before the callback returns.
2. ValidatorHandler may not introduce new elements that were not present in the input.
3. ValidatorHandler may not remove attributes that were present in the input.

当指定的ContentHandler上的回调方法引发异常时，必须从ValidatorHandler抛出相同的异常对象。 不应该通知ErrorHandler这样的例外。

即使在验证过程中也可以调用此方法。

setErrorHandler

void setErrorHandler (ErrorHandler errorHandler)

设置 ErrorHandler以接收验证过程中遇到的错误。

错误处理程序可用于在验证期间自定义错误处理过程。 当设置了ErrorHandler时，验证过程中发现的错误将首先发送到ErrorHandler 。

错误处理程序可以通过从处理程序中抛出SAXException立即中止进一步验证。 或者，例如，它可以向屏幕输出错误，并尝试通过从ErrorHandler正常返回来继续验证

如果任何 Throwable选自抛出 ErrorHandler ，相同的 Throwable对象将朝向调用堆栈的根被抛出。

ValidatorHandler不允许扔 SAXException没有首先将其报告给 ErrorHandler 。

当 ErrorHandler为空时，实现将表现得好像设置了以下 ErrorHandler ：

 class DraconianErrorHandler implements ErrorHandler {
     public void fatalError( SAXParseException e ) throws SAXException {
         throw e;
     }
     public void error( SAXParseException e ) throws SAXException {
         throw e;
     }
     public void warning( SAXParseException e ) throws SAXException {
         // noop
     }
 }
 

当新的 ValidatorHandler对象被创建时，最初这个字段被设置为空。

setFeature

void setFeature (String name, 
                boolean value)

设置功能标志的值。

功能可用于控制 ValidatorHandler解析架构的方式，但 ValidatorHandler不需要识别任何特定的属性名称。

功能名称是任何完全限定的URI。 ValidatorHandler可能会公开一个特征值，但无法更改当前值。 某些特征值只能在特定上下文中不可变或可变，例如在验证之前，期间或之后。

setProperty

void setProperty (String name, 
                Object object)

设置属性的值。

属性名称是任何完全限定的URI。 ValidatorHandler可能会识别属性名称，但无法更改当前值。 某些属性值只能在特定上下文中不可变或可变，例如在验证之前，期间或之后。

ValidatorHandler不需要识别设置任何特定的属性名称。

setResourceResolver

void setResourceResolver (LSResourceResolver resourceResolver)

设置 LSResourceResolver以在验证期间自定义资源分辨率。

ValidatorHandler在 LSResourceResolver时需要定位外部资源时使用 LSResourceResolver ，尽管“定位外部资源”的确切含义取决于每种模式语言。

当 LSResourceResolver为空时，实现将表现得好像设置了以下 LSResourceResolver ：

 class DumbLSResourceResolver implements LSResourceResolver {
     public LSInput resolveResource(
         String publicId, String systemId, String baseURI) {

         return null; // always return null
     }
 }
 

如果 LSResourceResolver引发 RuntimeException （或其派生类的实例），则 ValidatorHandler将中止解析，并且 validate方法的调用方将收到相同的 RuntimeException 。

当一个新的 ValidatorHandler对象被创建时，最初这个字段被设置为空。