首页 > 学院 > 开发设计 > 正文

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

2019-11-18 12:46:51
字体:
来源:转载
供稿:网友

  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

发表评论 共有条评论
用户名: 密码:
验证码: 匿名发表