この章では、Extensible Markup Language (XML) Schema Processor for Javaの使用方法について説明します。
内容は次のとおりです。
この章では、次のテクノロジについて実用的な知識があることを前提にしています。
Document Type Definition (DTD): XML Document Type Definition (DTD)は、XML文書の有効な構造を定義します。
XMLスキーマ言語: XMLスキーマは、XML文書の有効な構造を定義します。
これらのテクノロジの詳細は、「関連ドキュメント」のXMLの資料を参照してください。
関連項目:
http://www.w3schools.com/dtd/
にあるDTDのチュートリアル
http://www.w3schools.com/schema
にあるXML Schema言語のチュートリアル
XML Schemaは、World Wide Web Consortium (W3C)の標準です。XML Schemaの仕様は次の場所にあります。
http://www.w3.org/TR/xmlschema-0/
(W3C XML Schemaの入門書)
http://www.w3.org/TR/xmlschema-1/
(XML Schema言語の構造の定義)
http://www.w3.org/TR/xmlschema-2/
(XML Schema言語のデータ型の定義)
Oracle XML Schema Processorは、W3CのXML Schema仕様をサポートしています。
関連項目:
Oracle XML Developer's Kit (XDK)でサポートする標準の概要は、「Oracle XML Developer's Kit標準」を参照してください
Document Type Definition (DTD)は、当初SGML用に開発されました。XML DTDは、SGMLで使用可能なDTDのサブセットであり、XMLマークアップに対する制約を宣言するためのメカニズムを提供します。XML DTDによって、次のものを指定できます。
XML文書で使用できる要素。
XML要素のコンテンツ・モデル。つまり、要素にデータのみが含まれるか、またはその構造を定義するサブ要素のセットを含むか。DTDでは、サブ要素がオプションと必須のどちらであるか、またサブ要素の出現が1回のみか複数回可能かを定義します。
XML要素の属性。DTDでは、属性がオプションと必須のどちらであるかも指定できます。
XML文書で有効なエンティティ。
XML DTD自体はXMLで記述されているのではなく、XML文書の構造を定義するための、コンテキストに依存しない文法です。DTDは、XML文書内で、またはXML文書とは別のファイルで宣言できます。
検証とは、関連するDTDに対してXML文書が妥当であるかどうかを検証して、構造、要素の使用方法および属性の使用方法がDTDの定義と一致していることを確認するプロセスです。XML文書を処理するアプリケーションでは、検証によって、データと定義が一致することを想定できます。
XDKを使用すると、検証XMLパーサー(XML文書を解析して、その文書がDTDに対して妥当かどうかを検証するプログラム)を含むアプリケーションを作成できます。実装に応じて、検証パーサーは次のように動作します。
エラーの検出時に処理を停止するか、続行します。
警告およびエラーを発生時に報告するか、処理の最後に要約形式で報告します。
検証モードを有効化するか、無効化します。
ほとんどのプロセッサでは検証モードを有効または無効にできますが、いずれの場合もエンティティ定義とDTDのその他の構成メンバーは処理する必要があります。
例9-1に、family.dtd
という名前のDTDのコンテンツを示します。このDTDは$ORACLE_HOME/xdk/demo/java/parser/common/
にあります。<ELEMENT>
タグでは文書内の要素の有効な名称および構造を指定し、<ATTLIST>
タグでは要素の有効な属性を指定します。
例9-2に、family.xml
という名前のXML文書のコンテンツを示します。このXML文書は$ORACLE_HOME/xdk/demo/java/parser/common/
にあります。family.xml
の<!DOCTYPE>
要素では、このXML文書がfamily.dtd
という名前の外部DTDに準拠することを指定します。
例9-1 family.dtd
<?xml version="1.0" encoding="UTF-8"?> <!ELEMENT family (member*)> <!ATTLIST family lastname CDATA #REQUIRED> <!ELEMENT member (#PCDATA)> <!ATTLIST member memberid ID #REQUIRED> <!ATTLIST member dad IDREF #IMPLIED> <!ATTLIST member mom IDREF #IMPLIED>
例9-2 family.xml
<?xml version="1.0" standalone="no"?> <!DOCTYPE family SYSTEM "family.dtd"> <family lastname="Smith"> <member memberid="m1">Sarah</member> <member memberid="m2">Bob</member> <member memberid="m3" mom="m1" dad="m2">Joanne</member> <member memberid="m4" mom="m1" dad="m2">Jim</member> </family>
XML Schema定義とも呼ばれるXML Schema言語は、XML構文を使用してXML文書のコンテンツおよび構造を記述するためにW3Cで作成されました。XMLスキーマは、XML Schema言語で記述されたXML文書です。XMLスキーマ文書には、入力XML文書の構造を記述するインスタンス・ドキュメントと呼ばれるルールが含まれています。インスタンス・ドキュメントは、XMLスキーマのルールに準拠する場合のみ有効です。
XML Schema言語では、次のようなことを定義します。
インスタンス・ドキュメントで有効な要素および属性
他の要素の子にすることのできる要素
子要素の順序と数
要素と属性のデータ型
要素と属性のデフォルト値と固定値
検証XMLパーサーは、インスタンス・ドキュメントが関連XMLスキーマのルールに準拠しているかどうかの判断を試行します。XDKを使用すると、このスキーマ検証を実行する検証パーサーを作成できます。実装に応じて、検証パーサーは次のように動作します。
エラーの検出時に処理を停止するか、続行します。
警告およびエラーを発生時に報告するか、処理の最後に要約形式で報告します。
プロセッサは、インスタンス・ドキュメントによって含められたDTDに定義されているエンティティ定義およびその他の構成メンバーを考慮する必要があります。XML Schema言語では、インスタンス・ドキュメントにXMLスキーマとDTDの両方が含まれる場合に何を行う必要があるかは定義されていません。したがって、このような場合のアプリケーションの動作は実装によって決まります。
例9-3に、異なる地域で注文された部品を記述する購入レポートを含むサンプルXML文書を示します。このサンプル・ファイルは、$ORACLE_HOME/xdk/demo/java/schema/report.xml
にあります。
例9-4に、report.xsd
という名前のXMLスキーマ・ドキュメントを示します。このドキュメントは、report.xml
の検証に使用できるサンプルXMLスキーマ・ドキュメントです。XMLスキーマは特に、インスタンス・ドキュメントで有効な要素の名前と、要素に含めることのできるデータ型を定義します。
例9-3 report.xml
<purchaseReport xmlns="http://www.example.com/Report" xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.example.com/Report report.xsd" period="P3M" periodEnding="1999-12-31"> <regions> <zip code="95819"> <part number="872-AA" quantity="1"/> <part number="926-AA" quantity="1"/> <part number="833-AA" quantity="1"/> <part number="455-BX" quantity="1"/> </zip> <zip code="63143"> <part number="455-BX" quantity="4"/> </zip> </regions> <parts> <part number="872-AA">Lawnmower</part> <part number="926-AA">Baby Monitor</part> <part number="833-AA">Lapis Necklace</part> <part number="455-BX">Sturdy Shelves</part> </parts> </purchaseReport>
例9-4 report.xsd
<schema targetNamespace="http://www.example.com/Report" xmlns="http://www.w3.org/2001/XMLSchema" xmlns:r="http://www.example.com/Report" elementFormDefault="qualified"> <annotation> <documentation xml:lang="en"> Report schema for Example.com Copyright 2000 Example.com. All rights reserved. </documentation> </annotation> <element name="purchaseReport"> <complexType> <sequence> <element name="regions" type="r:RegionsType"> <keyref name="dummy2" refer="r:pNumKey"> <selector xpath="r:zip/r:part"/> <field xpath="@number"/> </keyref> </element> <element name="parts" type="r:PartsType"/> </sequence> <attribute name="period" type="duration"/> <attribute name="periodEnding" type="date"/> </complexType> <unique name="dummy1"> <selector xpath="r:regions/r:zip"/> <field xpath="@code"/> </unique> <key name="pNumKey"> <selector xpath="r:parts/r:part"/> <field xpath="@number"/> </key> </element> <complexType name="RegionsType"> <sequence> <element name="zip" maxOccurs="unbounded"> <complexType> <sequence> <element name="part" maxOccurs="unbounded"> <complexType> <complexContent> <restriction base="anyType"> <attribute name="number" type="r:SKU"/> <attribute name="quantity" type="positiveInteger"/> </restriction> </complexContent> </complexType> </element> </sequence> <attribute name="code" type="positiveInteger"/> </complexType> </element> </sequence> </complexType> <simpleType name="SKU"> <restriction base="string"> <pattern value="\d{3}-[A-Z]{2}"/> </restriction> </simpleType> <complexType name="PartsType"> <sequence> <element name="part" maxOccurs="unbounded"> <complexType> <simpleContent> <extension base="string"> <attribute name="number" type="r:SKU"/> </extension> </simpleContent> </complexType> </element> </sequence> </complexType> </schema>
XML Schema言語には、DTD仕様のほとんどの機能が含まれています。XMLスキーマはDTDと同様の目的を果しますが、文書制約の指定の柔軟性が高くなっています。表9-1で、2つの検証メカニズム間で一部の機能を比較します。
表9-1 XMLスキーマとDTDの機能の比較
機能 | XMLスキーマ | DTD |
---|---|---|
要素のネスト |
可 |
可 |
要素の出現の制約 |
可 |
可 |
許可される属性 |
可 |
可 |
属性タイプとデフォルト値 |
可 |
可 |
XMLでの記述 |
可 |
|
名前空間のサポート |
可 |
|
埋込みデータ型 |
可 |
|
ユーザー定義データ型 |
可 |
|
組込み/インポート |
可 |
|
再定義(継承) |
可 |
次に、DTD検証ではなくXMLスキーマ検証を選択する最大の理由を示します。
XMLスキーマ言語では、要素と属性のコンテンツのルールを定義できます。データ型を使用してコンテンツを制御できます。XML Schemaのデータ型では、次のようなアクションを簡単に実行できます。
どの要素にどのデータ型が含まれるかを宣言します。たとえば、ある要素に正の整数が含まれ、別の要素に年が含まれることを宣言します。
データベースから取得したデータを処理します。
10から20までの数値など、データに対する制限を定義します。
MM-DD-YYYY形式の日付など、データ形式を定義します。
文字列から日付など、異なるデータ型間でデータを変換します。
DTDの文法とは異なり、XML Schema言語で記述された文書自体はXMLで記述されています。したがって、次のアクションを実行できます。
XMLパーサーを使用したXMLスキーマの解析
XML Document Object Model (DOM)によるXMLスキーマの処理
Extensible Stylesheet Language Transformation (XSLT)によるXML文書の変換
他のXMLスキーマでのXMLスキーマの再利用
要素と属性の追加によるXMLスキーマの拡張
同じ文書からの複数のXMLスキーマの参照
Oracle XML Schema ProcessorはSAXベースのXMLスキーマ・バリデータであり、XMLスキーマに対してインスタンス・ドキュメントが妥当かどうかを検証するために使用できます。プロセッサでは、LAnguage eXample (LAX)と厳密な検証の両方がサポートされています。
プロセッサは次の方法で使用できます。
XMLパーサーで有効にします。
DOMツリーで使用して、XML文書の全体または一部を検証します。
処理パイプライン(コンテンツ・ハンドラなど)でコンポーネントとして使用します。
要件に応じて、様々な方法でSchema Processorを構成できます。たとえば、次のことが可能です。
固定のXMLスキーマを使用するか、インスタンス・ドキュメントのschemaLocation
属性に基づいてスキーマを自動的に構築します。
検証プロセスをより詳細に制御できるようにXMLError
およびentityResolver
を設定します。
インスタンス・ドキュメントをどの程度検証するかを決定します。表4-1に示した検証モードのいずれかを使用できます。検証のルートとして要素の型を指定することもできます。
次のXDKパッケージは、XMLスキーマを処理するアプリケーションで重要です。
XML解析用のAPIを提供するoracle.xml.parser.v2
XMLスキーマ処理用のAPIを提供するoracle.xml.parser.schema
表9-2に、oracle.xml.parser.schema
パッケージの最も重要なクラスを示します。これらのクラスは、ほとんどのXMLスキーマ・アプリケーションのコアを形成します。
表9-2 oracle.xml.parser.schemaのクラス
クラス/インタフェース | 説明 | メソッド |
---|---|---|
|
XML Schemaコンポーネント・モデルを表します。 |
主要なメソッドは次のとおりです。
|
|
型定義、要素と属性の宣言、グループと属性グループの定義など、ターゲット名前空間内のスキーマ・コンポーネントを表します。 |
主要なメソッドは |
|
XMLスキーマ文書から |
主要なメソッドは次のとおりです。
|
|
XMLスキーマに対してXMLインスタンス・ドキュメントが妥当かどうかを検証します。登録されている場合、 |
主要なメソッドは次のとおりです。
|
図9-1に、XML Schema Processorでインスタンス・ドキュメントを検証する基本プロセスを示します。
XML Schema Processorは、次の主要タスクを実行します。
ビルダー(XSDBuilder
オブジェクト)が、入力XMLスキーマ文書からXMLスキーマを作成します。インスタンス・ドキュメントおよびスキーマは、特にオペレーティング・システムにファイルとして存在する必要はありませんが、一般にファイルと呼ばれます。これらは、バイト・ストリーム、データベース・レコードのフィールドまたはXML Infosetの情報項目のコレクションとして存在できます。
このタスクには、スキーマ文書のオブジェクトへの解析が含まれます。ビルダーは、スキーマ・オブジェクトを明示的または暗黙的に作成します。
明示的モードでは、プロセッサを起動するときにXMLスキーマを渡します。「外部参照XMLスキーマに対する検証」では、明示的モードでのスキーマ・オブジェクトの作成方法について説明しています。
暗黙的モードでは、スキーマがインスタンス・ドキュメントにより内部的に参照されているため、プロセッサの起動時にXMLスキーマを渡しません。「内部参照XMLスキーマに対する検証」では、暗黙的モードでのスキーマ・オブジェクトの作成方法について説明しています。
XMLスキーマ・バリデータでは、スキーマ・オブジェクトを使用してインスタンス・ドキュメントを検証します。このタスクの手順は次のとおりです。
Simple API for XML (SAX)パーサーは、インスタンス・ドキュメントをSAXイベントに解析し、これをバリデータに渡します。
バリデータは、SAXイベントを入力として受け取り、これらがスキーマ・オブジェクトに対して妥当かどうかを検証し、無効なXMLコンポーネントが見つかった場合はエラー・メッセージを送信します。
「XMLパーサーでの検証」では、インスタンス・ドキュメントの検証時に使用できる検証モードについて説明しています。XSDBuilder
クラスを使用して検証用のスキーマを明示的に設定しない場合は、インスタンス・ドキュメントで正しいxsi:schemaLocation
属性がスキーマ・ファイルを指している必要があります。そうでない場合、プログラムは検証を実行しません。プロセッサでエラーが発生した場合は、エラー・メッセージが生成されます。
バリデータは、入力SAXイベント、デフォルト値またはスキーマ検証後の情報をDOMビルダーまたはアプリケーションに送信します。
関連項目:
XSDBuilder
、DOMParser
およびSAXParser
クラスの詳細は、Oracle Database XML Java APIリファレンスを参照してください
XDK SAXおよびDOMパーサーの詳細は、「XML Schema Processor for Javaの使用」を参照してください
XML Schema Processor for Javaのデモ・プログラムは、$ORACLE_HOME/xdk/demo/java/schema
に含まれています。表9-3で、XML Schema Processorのテストに使用できるXMLファイルとプログラムについて説明します。
表9-3 XML Schemaのサンプル・ファイル
ファイル | 説明 |
---|---|
cat.xsd |
|
catalogue.xml |
|
catalogue_e.xml |
|
DTD2Schema.java |
このサンプル・プログラムは、DTD(第1引数)をXML Schemaに変換し、これを使用してXMLファイル(第2引数)を検証します。 |
embeded_xsql.xsd |
|
embeded_xsql.xml |
|
juicer1.xml |
|
juicer1.xsd |
|
juicer2.xml |
|
juicer2.xsd |
|
report.xml |
XMLスキーマ |
report.xsd |
|
report_e.xml |
プログラムは、 |
xsddom.java |
このプログラムは、ドキュメントのDOM表現を取得し、 |
xsdent.java |
このプログラムは、 |
xsdent.xml |
このXML文書は書籍を記述します。ファイルは、 |
xsdent.xsd |
このXMLスキーマ文書は、 |
xsdent-1.xsd |
|
xsdproperty.java |
このデモは、複合型または要素宣言に基づいてXML文書を検証するようにXML Schema Processorを構成する方法を示します。 |
xsdsax.java |
このデモは、SAXストリームとして受け取ったXML文書の検証方法を示します。 |
XSDLax.java |
このデモは、 |
XSDSample.java |
このプログラムは、XMLインスタンス・ドキュメントの処理に使用できるサンプル・ドライバです。 |
XSDSetSchema.java |
このプログラムは、 |
サンプル・プログラムのコンパイル方法および実行方法は、同じディレクトリにあるREADME
に示されています。この場合、基本的な手順は次のようになります。
「XML Parserコマンドライン・ユーティリティ(oraxml)の使用」では、oraxml
コマンドライン・ユーティリティの実行方法を説明しています。このユーティリティを使用して、XMLスキーマとDTDに対してインスタンス・ドキュメントが妥当かどうかを検証できます。
$ORACLE_HOME/xdk/demo/java/schema
ディレクトリに変更します。例9-5に、コマンドラインで次のコマンドを実行することにより、report.xml
がreport.xsd
に対して妥当かどうかを検証する方法を示します。
予想される出力は次のとおりです。
The encoding of the input file: UTF-8 The input XML file is parsed without errors using Schema validation mode.
例9-5 oraxmlを使用したスキーマに対する検証
oraxml -schema -enc report.xml
$ORACLE_HOME/xdk/demo/java/parser/common
ディレクトリに変更します。例9-6に、コマンドラインで次のコマンドを実行することにより、family.xml
がfamily.dtd
に対して妥当かどうかを検証する方法を示します。
予想される出力は次のとおりです。
The encoding of the input file: UTF-8 The input XML file is parsed without errors using DTD validation mode.
例9-6 oraxmlを使用したDTDに対する検証
oraxml -dtd -enc family.xml
内容は次のとおりです。
$ORACLE_HOME/xdk/demo/java/schema/XSDSample.java
プログラムは、暗黙的なXMLスキーマに対して妥当かどうかを検証する方法を示します。XMLスキーマはインスタンス・ドキュメント自体で参照されているため、検証モードは暗黙的です。
この項の手順に従って、oracle.xml.parser.v2.
DOMParser
クラスのsetValidationMode()
メソッドを使用するプログラムを作成します。
$ORACLE_HOME/xdk/demo/java/schema/XSDSetSchema.java
プログラムは、XMLスキーマを明示的に検証する方法を示します。XSDBuilder
クラスを使用して検証用のスキーマを指定するため、検証モードは明示的です。暗黙的な検証の場合とは異なり、スキーマはインスタンス・ドキュメントでは指定されません。
この項の基本手順に従って、oracle.xml.parser.schema.XSDBuilder
クラスのbuild()
メソッドを使用するJavaプログラムを作成します。
LAXモードでは、文書全体を検証せずに、インスタンス・ドキュメントのXMLコンテンツの一部を検証できます。LAXパーサーは、関連するXMLスキーマで宣言されているインスタンス・ドキュメントの要素に対してプロセッサが検証を実行する必要があることを示します。プロセッサは、スキーマで宣言された要素がインスタンス・ドキュメントに含まれていない場合でも、そのインスタンス・ドキュメントを無効とみなしません。
LAXモードを使用することにより、XMLの検証対象部分に対してのみスキーマを定義できます。$ORACLE_HOME/xdk/demo/java/schema/XSDLax.java
プログラムは、LAX検証の使用方法を示します。このプログラムは、「外部参照XMLスキーマに対する検証」で説明している基本手順を実行します。
DOMParser.parse()
を起動することにより、XMLスキーマに対してインスタンス・ドキュメントが妥当かどうかを検証します。LAX検証を有効にするには、パーサーの検証モードをSCHEMA_VALIDATION
ではなくSCHEMA_LAX_VALIDATION
に設定します。XSDLax.java
の次のコード部分は、この方法を示します。
dp.setXMLSchema(schemadoc); dp.setValidationMode(XMLParser.SCHEMA_LAX_VALIDATION); dp.setPreserveWhitespace (true); . . .
サンプル・プログラムを次のように実行することにより、LAX検証をテストできます。
java XSDLax embeded_xsql.xsd embeded_xsql.xml
$ORACLE_HOME/xdk/demo/java/schema/xsdsax.java
プログラムは、SAXストリームとして受け取ったXML文書を検証する方法を示します。XSDValidator
をインスタンス化し、SAXパーサーにコンテンツ・ハンドラとして登録します。
この項の手順に従って、SAXストリームからXMLを検証するプログラムを作成します。
$ORACLE_HOME/xdk/demo/java/schema/xsddom.java
プログラムは、ドキュメントのDOM表現を取得し、XSDValidator
オブジェクトを使用してこれを検証することにより、インスタンス・ドキュメントを検証する方法を示します。
xsddom.java
プログラムは次の手順を実行します。
$ORACLE_HOME/xdk/demo/java/schema/xsdproperty.java
プログラムは、複合型または要素宣言に基づいてXML文書を検証するようにXML Schema Processorを構成する方法を示します。
xsdproperty.java
プログラムは次の手順を実行します。
インスタンス・ドキュメント名、XMLスキーマ名、ルート・ノードの名前空間、ルート・ノードのローカル名、および要素または複合型の指定("true"はルート・ノードが要素宣言であることを意味します)に関するString
オブジェクトを作成します。次のコード部分で、この方法を示します。
String xmlfile = args[0]; String xsdfile = args[1]; ... String ns = args[2]; //namespace for the root node String nm = args[3]; //root node's local name String el = args[4]; //true if root node is element declaration, // otherwise, the root node is a complex type
XSDビルダーを作成し、それを使用してスキーマ・オブジェクトを作成します。次のコード部分で、この方法を示します。
XSDBuilder builder = new XSDBuilder(); URL url = XMLUtil.createURL(xsdfile); XMLSchema schema; ... schema = (XMLSchema) builder.build(url);
ノードを取得します。ノードが要素宣言と複合型のどちらであるかに応じて異なるメソッドを起動します。
ノードが要素宣言である場合は、ローカル名と名前空間をスキーマ・オブジェクトのgetElement()
メソッドに渡します。
ノードが要素宣言である場合は、名前空間、ローカル名およびルート複合型をスキーマ・オブジェクトのgetType()
メソッドに渡します。
xsdproperty.java
は、次の制御構造を使用します。
QxName qname = new QxName(ns, nm); ... XSDNode nd; ... if (el.equals("true")) { nd = schema.getElement(ns, nm); /* process ... */ } else { nd = schema.getType(ns, nm, XSDNode.TYPE); /* process ... */ }
ノードを取得した後で、新規パーサーを作成し、スキーマをパーサーに設定してスキーマ検証を有効にします。次のコード部分で、この方法を示します。
DOMParser dp = new DOMParser(); URL url = XMLUtil.createURL (xmlURI);
パーサー上のプロパティを設定し、URLを解析します。schemaValidatorProperty()
メソッドを起動します。
パーサーのルート要素または型プロパティを完全修飾名に設定します。
最上位レベルの要素宣言では、process1()
メソッドで示されているように、プロパティ名をXSDNode.ROOT_ELEMENT
に設定し、値をQName
に設定します。
最上位レベルの型定義では、process2()
メソッドで示されているように、プロパティ名をXSDNode.ROOT_TYPE
に設定し、値をQName
に設定します。
パーサーのルート・ノード・プロパティを要素または複合型ノードに設定します。
要素ノードでは、process3()
メソッドで示されているように、プロパティ名をXSDNode.ROOT_NODE
に設定し、値をXSDElement
ノードに設定します。
型ノードでは、process3()
メソッドで示されているように、プロパティ名をXSDNode.ROOT_NODE
に設定し、値をXSDComplexType
ノードに設定します。
次のコード部分はメソッドの起動順序を示します。
if (el.equals("true")) { nd = schema.getElement(ns, nm); process1(xmlfile, schema, qname); process3(xmlfile, schema, nd); } else { nd = schema.getType(ns, nm, XSDNode.TYPE); process2(xmlfile, schema, qname); process3(xmlfile, schema, nd); }
処理メソッドは次のように実装されます。
static void process1(String xmlURI, XMLSchema schema, QxName qname) throws Exception { /* create parser... */ dp.setXMLSchema(schema); dp.setSchemaValidatorProperty(XSDNode.ROOT_ELEMENT, qname); dp.setPreserveWhitespace (true); dp.setErrorStream (System.out); dp.parse (url); ... } static void process2(String xmlURI, XMLSchema schema, QxName qname) throws Exception { /* create parser... */ dp.setXMLSchema(schema); dp.setSchemaValidatorProperty(XSDNode.ROOT_TYPE, qname); dp.setPreserveWhitespace (true); dp.setErrorStream (System.out); dp.parse (url); ... } static void process3(String xmlURI, XMLSchema schema, XSDNode node) throws Exception { /* create parser... */ dp.setXMLSchema(schema); dp.setSchemaValidatorProperty(XSDNode.ROOT_NODE, node); dp.setPreserveWhitespace (true); dp.setErrorStream (System.out); dp.parse (url); ... }
内容は次のとおりです。
XSDBuilder
は、スキーマを構築する場合に、schemaLocation
属性でURLとして指定された他のスキーマを組み込みまたはインポートすることが必要な場合があります。表9-3で説明したxsdent.java
デモでは、この事例を示しています。xsdent.xml
ファイルの文書要素には、次の属性が含まれます。
xsi:schemaLocation = "http://www.example.com/BookCatalogue xsdent.xsd">
xsdent.xsd
文書には、次の要素が含まれます。
<schema xmlns="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.example.com/BookCatalogue" xmlns:catd = "http://www.example.com/Digest" xmlns:cat = "http://www.example.com/BookCatalogue" elementFormDefault="qualified"> <import namespace = "http://www.example.com/Digest" schemaLocation = "xsdent-1.xsd" />
場合によっては、<import>
で指定したスキーマの場所をオーバーライドし、必要なスキーマ・ドキュメントをビルダーに提供することが必要になります。たとえば、スキーマ・ドキュメントを外部Webサイトからダウンロードし、それをデータベースに格納する場合があります。このような場合は、XSDBuilder
にエンティティ・リゾルバを設定できます。XSDBuilder
は、スキーマの場所をリゾルバに渡します。リゾルバは、InputStream
、Reader
またはURL
をInputSourceとして戻します。ビルダーは、InputSource
からスキーマ・ドキュメントを読み取ることができます。
xsdent.java
プログラムは、エンティティ・リゾルバを使用してスキーマの場所をオーバーライドする方法を示します。EntityResolver
インタフェースを実装し、エンティティ・リゾルバをインスタンス化し、それをXMLスキーマ・ビルダーに設定する必要があります。デモ・コードでは、sampleEntityResolver1
はInputSource
をInputStream
として戻しますが、sampleEntityResolver2
はInputSource
をURL
として戻します。
次の基本手順に従います。