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

      基本的步骤是: 

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