Validator

Validator

Validator ()

派生类的构造函数。

构造函数什么都不做。

派生类必须创建 Validator对象，其中包含 null ErrorHandler和 null LSResourceResolver 。

getErrorHandler

ErrorHandler getErrorHandler ()

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

getFeature

boolean getFeature (String name)

查找功能标志的值。

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

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

getProperty

Object getProperty (String name)

查找一个属性的值。

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

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

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

getResourceResolver

LSResourceResolver getResourceResolver ()

获取当前 LSResourceResolver设置为这个 Validator 。

reset

void reset ()

将此 Validator重置为其原始配置。

Validator被重置为与使用newValidator()创建时相同的状态。 reset()旨在允许重复使用现有的Validator从而节省与创建新的Validator相关的资源。

不保证重置Validator具有相同的LSResourceResolver或ErrorHandler Object ，例如equals(Object) 。 它保证有一个功能相同的LSResourceResolver和ErrorHandler 。

setErrorHandler

void setErrorHandler (ErrorHandler errorHandler)

将 ErrorHandler设置为接收 validate方法调用期间遇到的错误。

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

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

如果任何 Throwable选自抛出 ErrorHandler ，所述的呼叫者 validate方法将被抛出相同 Throwable对象。

Validator不允许扔 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
     }
 }
 

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

setFeature

void setFeature (String name, 
                boolean value)

设置功能标志的值。

功能可以用来控制 Validator解析模式的方式，但 Validator识别任何特定的属性名称。

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

setProperty

void setProperty (String name, 
                Object object)

设置属性的值。

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

Validators are not required to recognize setting any specific property names.

setResourceResolver

void setResourceResolver (LSResourceResolver resourceResolver)

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

Validator在 LSResourceResolver时需要定位外部资源时使用 LSResourceResolver ，但确切地说，构成“定位外部资源”的内容取决于每种模式语言。

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

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

         return null; // always return null
     }
 }
 

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

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

validate

void validate (Source source)

验证指定的输入。

这只是一个方便的方法：

 validate(source,null);
 

validate

void validate (Source source, 
                Result result)

验证指定的输入并将扩充的验证结果发送到指定的输出。

这个方法放在该类型的下列限制 Source / Result接受。

Source/Result accepted:

要将一个 Source验证为另一种类型的 Result ，请使用标识变换器（请参阅 newTransformer() ）。

验证过程中发现的错误将发送到指定的 ErrorHandler 。

如果文档有效，或者文档包含一些错误，但没有一个是致命的，并且 ErrorHandler没有抛出任何异常，则该方法正常返回。