模式验证结构-JAXP 1.3 的特性

核心提示：xml 处理的java API (JAXP) 1.3在Java 2 平台里已经首先引入了, 标准版(J2SE) 5.0 并且同样也在目前已可使用的Java Web Services Developer Pack (Java WSDP)中 ， JAXP 1.3 新增了一个模式验证结构(SVF), 也叫验证API, 它提供

　　xml 处理的java API (JAXP) 1.3在Java 2 平台里已经首先引入了, 标准版(J2SE) 5.0 并且同样也在目前已可使用的Java Web Services Developer Pack (Java WSDP)中 。 JAXP 1.3 新增了一个模式验证结构(SVF), 也叫验证API, 它提供了依靠模式高效验证XML的高级能力。SVF同样也提供了比JAXP 1.2中更高的执行效率。
　　
　　在考察SVF之前, 我们看看早期的模式验证方法。以下的代码片断示范了SAX解析的方法：
　　SAXParserFactory sf = SAXParserFactory.newInstance();
　　sf.setNamespaceAware(true);
　　sf.setValidating(true);
　　SAXParser sp = sf.newSAXParser();
　　sp.setPRoperty(
　　SCHEMA_LANGUAGE, XMLConstants.W3C_XML_SCHEMA_NS_URI);
　　sp.setProperty(SCHEMA_SOURCE, schema);　 sp.parse(new File(xml), dh);
　　
　　基本的步骤是:
　　
　　1.创建一个SAXParserFactory 对象。
　　
　　2.配置SAXParserFactory对象来生成支持XML命名空间的分析程序, 以及需要解析的验证文档。
　　
　　3.创建一个SAX 分析程序。
　　
　　4.设置SAX 分析程序属性的模式语言和模式来源。在本例中为W3C XML模式。
　　
　　5.解析文件。
　　
　　注重,这个过程的耦合验证和XML处理。
　　
　　作为比较, SVF方法中, XML文件模式验证从XML 处理中分离出来。SVP方法的第一步是编译模式:
　　
　　final String sl = XMLConstants.W3C_XML_SCHEMA_NS_URI;　 SchemaFactory factory = SchemaFactory.newInstance(sl);　 StreamSource ss = new StreamSource("mySchema.xsd");　 Schema schema = factory.newSchema(ss);
　　
　　SchemaFactory是一个模式编译器。它读指定的模式, 根据指定的模式语言的约束来检查模式语法和语义, 并且返回一个在内存中不变的Schema对象。不可变意味着一旦创建了Schema对象约束设置就不可改变。一个应用程序使用同一个Schema对象验证同样的文件两次也总会得到同样的结果。
　　
　　然后，您使用模式验证一个XML文件。根据你的需要将有三个方法可供选择：
　　
　　·在DocumentBuilderFactory 或SAXParserFactory上设置了Schema实例
　　
　　·创建一个Validator
　　
　　·创建一个ValidatorHandler (验证SAX流)
　　
　　所有这三个方法都保证, XML文件只在从Schema实例中获得的模式中有效。
　　
　　查看第一种方法, 在一个factory上设置Schema实例:
　　
　　SAXParserFactory spf = SAXParserFactory.newInstance();　 spf.setSchema(schema);　 SAXParser parser = spf.newSAXParser();　 parser.parse(<XML DOCUMENT>);
　　
　　在这里, 同一个Schema实例传输到所有的由SAXParserFactory创建的SAXParser实例中。SAXParser对象解析XML 文件并且同时验证它所依靠的Schema实例。 由于SAXParser并不为需要解析的每个XML文件都反复装载模式，这个方法可为整个模式处理提高相当的效率。与前面的方法比较，前面需要为每个需要验证的XML文件重复的装载指定的模式。
　　
　　在您装载一个Schema对象到内存以后, 您能采用第二个方法,通过Schema对象使用Validator 验证XML 文件。首先您从Schema对象中创建一个Validator 对象。 然后调用在Validator 对象中的validate() 方法来验证:
　　
　　Validator v = schema.newValidator();　 v.validate(new StreamSource(xml));
　　
　　Validator对象接受java.xml.transform.Source作为输入。 这意味着, 它可接受基于事件, SAX 源(SAXSource) 和基于对象, 文档对象模型(DOM) 源(DOMSource) 。 接受DOMSource作为输入, Validator能由指定的Schema对象验证一个在内存中的DOM文件或节点。
　　
　　Validator v = schema.newValidator();　 v.validate(new DOMSource(<DOM NODE>));
　　
　　假如要验证一个DOM 节点或指定的SAXSource，您也可考虑Validator方法。既使SAX 驱动器的执行是来自另外的一个供营商这个方法仍然可以运作。
　　
　　第三个方法是创建一个非凡设计的javax.xml.validation.ValidatorHandler来验证SAX 事件：
　　
　　SAXParserFactory spf = SAXParserFactory.newInstance();　 spf.setNamespaceAware(true);　 XMLReader reader = spf.newSAXParser().getXMLReader();　 ValidatorHandler vh =　schema.newValidatorHandler();　 //key is to set "ValidatorHandler" as ContentHandler　　//so that SAX event can be validated　 reader.setContentHandler(vh);　 reader.parse(xml);
　　
　　注重验证SAX事件, 您需要设置ValidatorHandler 为ContentHandler 。
　　
　　使用ValidatorHandler, 您也能利用模式验证一个JDOM 文件。 实际上, 任一个可在一个SAX流顶部建立或可产生SAX事件的对象模型(譬如XOM 和DOM4J)能由SVF利用一个模式来验证XML 文件。 这是可能的，因为ValidationHandler 能验证一个SAX流。 以下代码片断说明了一个JDOM文件是如何利用一个模式来验证的，假设你已经获取了前面例子中显示的ValidatorHandler：
　　
　　SAXOutputter so = new SAXOutputter(vh);　 so.output(jdomDocument);
　　
　　SAXOutputter 对象为JDOM 文件释放SAX事件。 SAX 事件然后由ValidatorHandler验证。
　　
　　您能使用SVF做的其它事是, 譬如在转换以后验证XML或获得模式类型信息。使用SVF的更多信息请参考：Easy and Efficient XML Processing: Upgrade to JAXP 1.3
　　
　　运行例代码
　　
　　范例程序包伴有本提示。 范例程序包中的代码包括编码实例和展示技术报道信息。在这个程序包里还有额外范例。 例如, 其中一个例子比较使用新的SVF模式验证性能和设置二个模式属性的前面的方法。 其它范例显示利用模式怎么验证Transformer的输出。 安装和运行范例:
　　
　　1.下载sample file并解压缩其内容。你能在形如<install_dir>\ValidationFramework的目录中看到解压缩出来的目录。例如，假如你解压缩内容到一台Windows机器上的C:\中，你最近创造的目录就应该是C:\ValidationFramework 。解压缩出来的内容包括一个README文件，此文件中包括了运行例子的介绍。你能使用在J2SE 5.0或者Java WSDP 1.6平台上的JAXP 1.3来运行例程序。你也能下载在java.net 上的JAXP 项目页面中的standalone JAXP 1.3 implementation 。
　　
　　2.运行ValidationFramework 目录中的ant图标。要编译使用如下的命令：
　　ant compile
　　
　　反馈信息中，你会看到如下的内容：
　　Buildfile: build.xml
　　
　　init:
　　
　　[mkdir] Created dir: C:\ValidationFramework\build
　　[mkdir] Created dir:
　　C:\ValidationFramework\build\classes
　　
　　compile:
　　
　　[echo] C:\Program Files\Java\jdk1.5.0\jre
　　...
　　
　　BUILD SUCCESSFUL
　　
　　要运行例子，利用适当的目标来运行ant命令，例如：
　　ant ValidateSAXStream
　　
　　在反馈的信息中，你会看到如下的信息输出：
　　[java] startElement: personnel
　　[java] startElement: person
　　[java] startElement: name
　　[java] startElement: family
　　[java] characters: Boss
　　[java] endElement: family
　　...
　　
　　[java] startElement: email
　　[java] characters: five@foo.com
　　[java] endElement: email
　　[java] startElement: link
　　[java] endElement: link
　　[java] endElement: person
　　[java] endElement: personnel
　　
　　BUILD SUCCESSFUL
　　
　　假如你在J2SE 5.0中运行例子，不考虑JAXP jar的位置的'endorsed' 属性。例如：
　　ant -Dendorsed=/space/jaxp/jaxp-1_3/dist/ Validate