パッケージ javax.xml.validation

このパッケージは、XML ドキュメントの検証するための API を提供します。

参照: 説明

クラスのサマリー

クラス	説明
Schema	文法の不変のメモリー内表現。
SchemaFactory	Schema オブジェクトを作成するファクトリです。API 検証のエントリポイントです。
SchemaFactoryLoader	SchemaFactory を作成するファクトリです。
TypeInfoProvider	このクラスは ValidatorHandler によって判定された型情報にアクセスできます。
Validator	Schema と照合して XML ドキュメントをチェックするプロセッサです。
ValidatorHandler	SAX ストリームに有効なストリーミングバリデータ。

パッケージ javax.xml.validation の説明

このパッケージは、XML ドキュメントの検証するための API を提供します。検証とは、XML ドキュメントが指定された XML スキーマのインスタンスであることを検証するプロセスです。XML スキーマは、そのインスタンスドキュメントが表すコンテンツモデル(「文法」または「ボキャブラリ」とも呼ばれる) を定義します。

XML スキーマの作成には、広く利用されている専門言語が数多く存在します。もっとも代表的な言語は次のとおりです。

• 文書型定義 (DTD) - XML の組み込み型スキーマ言語。
• W3C XML Schema(WXS) - オブジェクト指向の XML スキーマ言語。WXS も XML ドキュメントの文字データを制約するタイプシステムを提供する。WXS は、World Wide Web Consortium (W3C) によって管理されている W3C 勧告。つまり、批准された W3C 標準仕様である。
• RELAX NG (RNG)- パターンベースのユーザーフレンドリーな XML スキーマ言語。RNG スキーマも XML 文字データを制約する型を使用する。RNG は、Organization for the Advancement of Structured Information Standards (OASIS) によって管理されている、OASIS および ISO (International Organization for Standardization) 標準である。
• Schematron - ルールベースの XML スキーマ言語。DTD、WXS、および RNG は、コンテンツモデルの構造を表現するために設計されているのに対し、Schematron は、ほかのスキーマ言語で表現が難しい、あるいは表現できない個別ルールを実行するために設計されている。Schematron は、前述の構造的スキーマ言語で書かれたスキーマを補足するためのものである。現在、ISO 標準となる過程にある。

以前のバージョンの JAXP は、SAXParser または DocumentBuilder インスタンスで表される、XML パーサーの機能としての検証をサポートしていました。

JAXP 検証 API は、XML ドキュメントの構文解析からインスタンスドキュメントの検証を分離します。これが役立つのは、次のような理由からです。

• 追加のスキーマ言語のサポート。 JDK 1.5 では、もっとも標準的な JAXP パーサー実装である Crimson と Xerces がサポートしているのは有効な XML スキーマ言語のサブセットだけである。検証 API では、アプリケーションが追加のスキーマ言語をサポートする特殊化検証ライブラリのメリットを活かせる標準メカニズムを提供する。
• XML インスタンスおよびスキーマの容易な実行時の連結。 JAXP パーサーによる検証に使用するスキーマの位置の特定は混乱を招くことがある。検証 API を使用すると、このプロセスが簡素化される (次の例を参照)。

使用例。次の例は、検証 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) メソッドを使用して DocumentBuilderFactory または SAXParserFactory インスタンスに関連付けます。1 つのパーサーファクトリでスキーマの設定と setValidating(true) の呼び出しの両方を行わないでください。前者の技術ではパーサーは新しい検証 API を使用し、後者の技術ではパーサーは自身の内部検証機能を使用します。この 2 つのオプションを同時に有効にすると、冗長動作またはエラーの原因となります。