站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

javax.xml.validation (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版


JavaTM Platform
Standard Ed. 6

软件包 javax.xml.validation

此包提供了用于 XML 文档验证的 API。

请参见:
          描述

类摘要
Schema 不可变的语法存储表示形式。
SchemaFactory 创建 Schema 对象的工厂。
SchemaFactoryLoader 创建 SchemaFactory 的工厂。
TypeInfoProvider 此类提供了对 ValidatorHandler 所确定的类型信息的访问。
Validator 根据 Schema 检查 XML 文档的处理器。
ValidatorHandler 处理 SAX 流的流验证器。
 

软件包 javax.xml.validation 的描述

此包提供了用于 XML 文档验证的 API。Validation 是验证 XML 文档是否为指定 XML schema 的实例的过程。XML 模式定义了其实例文档将表示的内容模式(也称为 grammarvocabulary)。

有多种流行的技术用于创建 XML 模式。最流行的技术包括:

以前的 JAXP 版本支持作为 XML 解析器的功能的验证,要么通过 SAXParser 实例,要么通过 DocumentBuilder 实例来表示。

JAXP 验证 API 从 XML 文档解析中分离出实例文档的验证。这具有几种优点,一些原因包括:

用例以下示例演示了通过 Validation API 验证 XML 文档(为了方便阅读,此例未显示某些异常处理):

            
    // parse an XML document into a DOM tree
    DocumentBuilder parser = DocumentBuilderFactory.newInstance().newDocumentBuilder();
    Document document = parser.parse(new File("instance.xml"));

    // create a SchemaFactory capable of understanding WXS schemas
    SchemaFactory factory = SchemaFactory.newInstance(XMLConstants.W3C_XML_SCHEMA_NS_URI);

    // load a WXS schema, represented by a Schema instance
    Source schemaFile = new StreamSource(new File("mySchema.xsd"));
    Schema schema = factory.newSchema(schemaFile);

    // create a Validator instance, which can be used to validate an instance document
    Validator validator = schema.newValidator();

    // validate the DOM tree
    try {
        validator.validate(new DOMSource(document));
    } catch (SAXException e) {
        // instance document is invalid!
    }

JAXP 解析 API 已经与验证 API 进行了集成。应用程序可以通过验证 API 创建 Schema,并通过使用 DocumentBuilderFactory.setSchema(Schema)SAXParserFactory.setSchema(Schema) 方法将其与 DocumentBuilderFactorySAXParserFactory 实例进行关联。您不能既设置模式,又调用解析器工厂上的 setValidating(true)。前者的技术将导致解析器使用新的验证 API,后者将导致解析器使用它们自己的内部验证工具。同时调整这两个选项将导致冗余行为或错误条件。


JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策