java.applet

java.awt

java.awt.color

java.awt.datatransfer

java.awt.dnd

java.awt.event

java.awt.font

java.awt.geom

java.awt.im

java.awt.im.spi

java.awt.image

java.awt.image.renderable

java.awt.print

java.beans

java.beans.beancontext

java.io

java.lang

java.lang.annotation

java.lang.instrument

java.lang.management

java.lang.ref

java.lang.reflect

java.math

java.net

java.nio

java.nio.channels

java.nio.channels.spi

java.nio.charset

java.nio.charset.spi

java.rmi

java.rmi.activation

java.rmi.dgc

java.rmi.registry

java.rmi.server

java.security

java.security.acl

java.security.cert

java.security.interfaces

java.security.spec

java.sql

java.text

java.util

java.util.concurrent

java.util.concurrent.atomic

java.util.concurrent.locks

java.util.jar

java.util.logging

java.util.prefs

java.util.regex

java.util.zip

javax.accessibility

javax.activity

javax.crypto

javax.crypto.interfaces

javax.crypto.spec

javax.imageio

javax.imageio.event

javax.imageio.metadata

javax.imageio.plugins.bmp

javax.imageio.plugins.jpeg

javax.imageio.spi

javax.imageio.stream

javax.management

javax.management.loading

javax.management.modelmbean

javax.management.monitor

javax.management.openmbean

javax.management.relation

javax.management.remote

javax.management.remote.rmi

javax.management.timer

javax.naming

javax.naming.directory

javax.naming.event

javax.naming.ldap

javax.naming.spi

javax.net

javax.net.ssl

javax.print

javax.print.attribute

javax.print.attribute.standard

javax.print.event

javax.rmi

javax.rmi.CORBA

javax.rmi.ssl

javax.security.auth

javax.security.auth.callback

javax.security.auth.kerberos

javax.security.auth.login

javax.security.auth.spi

javax.security.auth.x500

javax.security.cert

javax.security.sasl

javax.sound.midi

javax.sound.midi.spi

javax.sound.sampled

javax.sound.sampled.spi

javax.sql

javax.sql.rowset

javax.sql.rowset.serial

javax.sql.rowset.spi

javax.swing

javax.swing.border

javax.swing.colorchooser

javax.swing.event

javax.swing.filechooser

javax.swing.plaf

javax.swing.plaf.basic

javax.swing.plaf.metal

javax.swing.plaf.multi

javax.swing.plaf.synth

javax.swing.table

javax.swing.text

javax.swing.text

javax.swing.text.parser

javax.swing.text.rtf

javax.swing.tree

javax.swing.undo

javax.transaction

javax.transaction.xa

javax.xml

javax.xml.datatype

javax.xml.namespace

javax.xml.parsers

javax.xml.transform

javax.xml.transform.dom

javax.xml.transform.sax

javax.xml.transform.stream

javax.xml.validation

javax.xml.xpath

org.ietf.jgss

org.omg.CORBA

org.omg.CORBA_2_3

org.omg.CORBA_2_3.portable

org.omg.CORBA.DynAnyPackage

org.omg.CORBA.ORBPackage

org.omg.CORBA.portable

org.omg.CORBA.TypeCodePackage

org.omg.CosNaming

org.omg.CosNaming.NamingContextExtPackage

org.omg.CosNaming.NamingContextPackage

org.omg.Dynamic

org.omg.DynamicAny

org.omg.DynamicAny.DynAnyFactoryPackage

org.omg.DynamicAny.DynAnyPackage

org.omg.IOP

org.omg.IOP.CodecFactoryPackage

org.omg.IOP.CodecPackage

org.omg.Messaging

org.omg.PortableInterceptor

org.omg.PortableInterceptor.ORBInitInfoPackage

org.omg.PortableServer

org.omg.PortableServer.CurrentPackage

org.omg.PortableServer.POAManagerPackage

org.omg.PortableServer.POAPackage

org.omg.PortableServer.portable

org.omg.PortableServer.ServantLocatorPackage

org.omg.SendingContext

org.omg.stub.java.rmi

org.w3c.dom

org.w3c.dom.bootstrap

org.w3c.dom.events

org.w3c.dom.ls

org.xml.sax

org.xml.sax.ext

org.xml.sax.helpers

allclasses-frame

allclasses-noframe

constant-values

deprecated-list

help-doc

JavaTM 2 Platform
Standard Ed. 5.0

javax.xml.validation
类 Validator

java.lang.Object
  继承者 javax.xml.validation.Validator

public abstract class Validator
extends Object

根据 Schema 检查 XML 文档的处理器。

验证器是线程不安全的、非重入的对象。换句话说,应用程序负责确保在任意给定时刻不能有多个线程使用 Validator 对象,且当调用 validate 方法时,应用程序不能以递归方式调用 validate 方法。

注意,当 validate(javax.xml.transform.Source)validate(javax.xml.transform.Source, javax.xml.transform.Result) 方法带有 Source 实例时,Source 实例必须为 SAXSourceDOMSource

从以下版本开始:
1.5

构造方法摘要
protected Validator()
          派生类的构造方法。
 
方法摘要
abstract  ErrorHandler getErrorHandler()
          获取设置为此 Validator 的当前 ErrorHandler
 boolean getFeature(String name)
          查找功能标志的值。
 Object getProperty(String name)
          查找属性值。
abstract  LSResourceResolver getResourceResolver()
          获取设置为此 Validator 的当前 LSResourceResolver
abstract  void reset()
          将此 Validator 重置为其初始配置。
abstract  void setErrorHandler(ErrorHandler errorHandler)
          设置 ErrorHandler 以接收在 validate 方法调用期间遇到的错误。
 void setFeature(String name, boolean value)
          设置功能标志的值。
 void setProperty(String name, Object object)
          设置属性值。
abstract  void setResourceResolver(LSResourceResolver resourceResolver)
          设置 LSResourceResolver 以自定义验证期间的资源解析。
 void validate(Source source)
          验证指定的输入。
abstract  void validate(Source source, Result result)
          验证指定输入并将扩充的验证结果发送到指定输出。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

Validator

protected Validator()
派生类的构造方法。

构造方法不执行动作。

派生类必须创建具有 null ErrorHandlernull LSResourceResolverValidator 对象。

方法详细信息

reset

public abstract void reset()

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

Validator 被重置为通过 Schema.newValidator() 创建它时的状态。reset() 在设计上旨在允许重用现有的 Validator,从而节省与创建新的 Validator 相关的资源。

不保证重置的 Validator 具有相同的 LSResourceResolverErrorHandler Object,例如 Object.equals(Object obj)。但保证具有功能相等的 LSResourceResolverErrorHandler


validate

public void validate(Source source)
              throws SAXException,
                     IOException
验证指定的输入。

这只是以下方法的一种便捷方法:

 validate(source,null);
 

抛出:
SAXException
IOException
另请参见:
setErrorHandler(ErrorHandler)

validate

public abstract void validate(Source source,
                              Result result)
                       throws SAXException,
                              IOException
验证指定输入并将扩充的验证结果发送到指定输出。

此方法对所接受的 Source/Result 的类型设置了以下限制。

所接受的 Source/Result

SAXSource DOMSource
null OK OK
SAXResult OK Err
DOMResult Err OK

注意,不允许使用 StreamSource 实例。 要处理 StreamSource,或验证要处理为另一种类型的 ResultSource,请使用恒等转换器(参见 TransformerFactory.newTransformer())。

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

如果文档有效,或文档包含某些错误但无致命错误且 ErrorHandler 不抛出任何异常,则该方法正常返回。

参数:
source - 要验证的 XML。不能为 null。
result - 接收(可能是扩充的)XML 的 Result 对象。如果调用方不需要它,则此参数可以为 null。 注意,当使用 DOMResult 时,验证器可以只是将来自 DOMSource 的相同 DOM 节点传递到 DOMResult(在这种情况下 source.getNode()==result.getNode()),它可能复制整个 DOM 树,或者更改源所给定的节点。
抛出:
IllegalArgumentException - 如果 Result 类型与 Source 类型不匹配,或者指定的源既不是 SAXSource,也不是 DOMSource
SAXException - 如果 ErrorHandler 抛出 SAXException,或者发现致命错误且 ErrorHandler 正常返回。
IOException - 如果验证器正在处理 SAXSource 且基础 XMLReader 抛出了 IOException
NullPointerException - 如果 source 参数为 null。
另请参见:
validate(Source)

setErrorHandler

public abstract void setErrorHandler(ErrorHandler errorHandler)
设置 ErrorHandler 以接收在 validate 方法调用期间遇到的错误。

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

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

如果从 ErrorHandler 抛出任何 Throwable,则 validate 方法的调用方将接收相同的 Throwable 对象。

Validator 未首先向 ErrorHandler 报告之前,不能抛出 SAXException

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
     }
 }
 

当创建新 Validator 对象时,此字段在初始化时被设置为 null。

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

getErrorHandler

public abstract ErrorHandler getErrorHandler()
获取设置为此 Validator 的当前 ErrorHandler

返回:
此方法返回通过 setErrorHandler(ErrorHandler) 方法设置的最后一个对象,如果自从创建此 Validator 以来一直未调用该方法,则返回 null。
另请参见:
setErrorHandler(ErrorHandler)

setResourceResolver

public abstract void setResourceResolver(LSResourceResolver resourceResolver)
设置 LSResourceResolver 以自定义验证期间的资源解析。

在验证期间,Validator 在需要查找外部资源时使用 LSResourceResolver,虽然“查找外部资源”的准确含义取决于每种模式语言。

LSResourceResolver 为 null 时,实现的行为就好像设置了以下 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 对象时,此字段在初始化时被设置为 null。

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

getResourceResolver

public abstract LSResourceResolver getResourceResolver()
获取设置为此 Validator 的当前 LSResourceResolver

返回:
此方法返回通过 setResourceResolver(LSResourceResolver) 方法设置的最后一个对象,如果自从创建此 Validator 以来一直未调用该方法,则返回 null。
另请参见:
setErrorHandler(ErrorHandler)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,