构造方法详细信息

• ValidatorHandler

  protected ValidatorHandler()

  派生类的构造函数。

  构造函数什么都不做。

  派生类必须创建具有null ErrorHandler和null LSResourceResolver的 ValidatorHandler个对象。

方法详细信息

• setContentHandler

  public abstract void setContentHandler​(ContentHandler receiver)

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

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

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

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

  1. 当ContentHandler.startElement(String, String, String, Attributes) ， ContentHandler.endElement(String, String, String) ， ContentHandler.startDocument() ，或ContentHandler.endDocument()被在调用ValidatorHandler ，在用户指定的相同的方法ContentHandler必须调用回调返回之前相同的事件。
  2. ValidatorHandler可能不会引入输入中不存在的新元素。
  3. ValidatorHandler可能不会删除输入中存在的属性。

  当指定的ContentHandler上的回调方法抛出异常时，必须从ValidatorHandler抛出相同的异常对象。 不应通知ErrorHandler此类例外情况。

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

  参数

  receiver - A ContentHandler或空值。

• getContentHandler

  public abstract ContentHandler getContentHandler()

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

  结果

  此方法返回通过getContentHandler()方法最后设置的对象，如果自ValidatorHandler创建以来从未调用过该方法，则返回null。

  另请参见：

  setContentHandler(ContentHandler)

• setErrorHandler

  public abstract void setErrorHandler​(ErrorHandler errorHandler)

  设置ErrorHandler以接收验证期间遇到的错误。

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

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

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

  ValidatorHandler不允许先抛出SAXException而不先将其报告给ErrorHandler 。

  当ErrorHandler为null时，实现的行为就像设置了以下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对象时，最初将此字段设置为null。

  参数

  errorHandler - 要设置的新错误处理程序。 此参数可以为null。

• getErrorHandler

  public abstract ErrorHandler getErrorHandler()

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

  结果

  此方法返回通过setErrorHandler(ErrorHandler)方法最后设置的对象，如果自ValidatorHandler创建以来从未调用过该方法，则返回null。

  另请参见：

  setErrorHandler(ErrorHandler)

• setResourceResolver

  public abstract void setResourceResolver​(LSResourceResolver resourceResolver)

  设置LSResourceResolver以在验证剧集中自定义资源分辨率。

  ValidatorHandler在验证时需要定位外部资源时使用LSResourceResolver ，尽管究竟是什么构成“定位外部资源”取决于每种模式语言。

  当LSResourceResolver为null时，实现的行为就像设置了以下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对象时，最初将此字段设置为null。

  参数

  resourceResolver - 要设置的新资源解析程序。 此参数可以为null。

• getResourceResolver

  public abstract LSResourceResolver getResourceResolver()

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

  结果

  此方法返回通过setResourceResolver(LSResourceResolver)方法最后设置的对象，如果从ValidatorHandler创建以来从未调用过该方法，则返回null。

  另请参见：

  setErrorHandler(ErrorHandler)

• getTypeInfoProvider

  public abstract TypeInfoProvider getTypeInfoProvider()

  获得此ValidatorHandler的TypeInfoProvider实现。

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

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

  结果

  如果验证器/模式语言不支持TypeInfo的概念，则返回null 。 否则为非null有效TypeInfoProvider 。

• getFeature

  public boolean getFeature​(String name)
                     throws SAXNotRecognizedException,
                            SAXNotSupportedException

  查找功能标志的值。

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

  实现者可以免费（并鼓励）使用基于自己的URI构建的名称来发明自己的功能。

  参数

  name - 功能名称，它是一个非null的完全限定URI。

  结果

  功能的当前值（true或false）。

  异常

  SAXNotRecognizedException - 如果无法分配或检索特征值。

  SAXNotSupportedException - 当ValidatorHandler识别出功能名称但此时无法确定其值。

  NullPointerException - 时 name是 null 。

  另请参见：

  setFeature(String, boolean)

• setFeature

  public void setFeature​(String name,
                         boolean value)
                  throws SAXNotRecognizedException,
                         SAXNotSupportedException

  为此ValidatorHandler设置功能。

  功能可用于控制ValidatorHandler解析模式的方式。 功能名称是任何完全限定的URI。 SchemaFactory可以公开特征值但无法更改当前值。 某些特征值可能仅在特定上下文中是不可变的或可变的，例如在验证之前，期间或之后。

  所有实现都需要支持XMLConstants.FEATURE_SECURE_PROCESSING功能。 当功能是：

  • true ：实现将限制XML处理以符合实现限制。 示例包括实体扩展限制和消耗大量资源的XML Schema构造。 如果出于安全原因限制XML处理，则将通过对已注册的ErrorHandler.fatalError(SAXParseException exception)的调用来报告。 见setErrorHandler(ErrorHandler errorHandler) 。
  • false ：实现将根据XML规范处理XML，而不考虑可能的实现限制。

  参数

  name - 功能名称，它是一个非null的完全限定URI。

  value - 要求的要素值（true或false）。

  异常

  SAXNotRecognizedException - 如果无法分配或检索特征值。

  SAXNotSupportedException - 当ValidatorHandler识别出功能名称但无法设置请求的值时。

  NullPointerException - 时 name是 null 。

  另请参见：

  getFeature(String)

• setProperty

  public void setProperty​(String name,
                          Object object)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

  设置属性的值。

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

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

  参数

  name - 属性名称，它是一个非null的完全限定URI。

  object - 属性的请求值。

  异常

  SAXNotRecognizedException - 如果无法分配或检索属性值。

  SAXNotSupportedException - 当ValidatorHandler识别属性名称但无法设置请求的值时。

  NullPointerException - 时 name是 null 。

• getProperty

  public Object getProperty​(String name)
                     throws SAXNotRecognizedException,
                            SAXNotSupportedException

  查找属性的值。

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

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

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

  参数

  name - 属性名称，它是一个非null的完全限定URI。

  结果

  属性的当前值。

  异常

  SAXNotRecognizedException - 如果无法分配或检索属性值。

  SAXNotSupportedException - 当XMLReader识别属性名称但此时无法确定其值时。

  NullPointerException - 时 name是 null 。

  另请参见：

  setProperty(String, Object)