この章の内容は次のとおりです。
Oracle XML JavaBeansは、Javaのアプリケーションおよびアプレットで使用できるXMLコンポーネントのセットです。
この項の内容は次のとおりです。
この章では、次のテクノロジを十分に理解していると想定します。
JavaBeans: JavaBeansのコンポーネント(Bean)は、ビルダー・ツールでビジュアルに操作できる再利用可能なソフトウェア・コンポーネントです。
Java Database Connectivity (JDBC): XDK JavaBeansにはデータベースへの接続性もあります。XDK JavaBeansはJDBC対応のデータベースに直接接続して、XMLファイルやXSLファイルを取得および格納できます。
Document Object Model (DOM): DOMは、XML文書の構造を示すインメモリー・ツリー表現です。
Simple API for XML (SAX): SAXは、イベントベースのXML解析の標準です。
XMLスキーマ言語: 概要および関連資料へのリンクは、第7章「Schema Processor for Javaの使用」を参照してください。
XDK JavaBeansには、XDKバージョン1.2以上が必要です。XDK JavaBeansは、JDK 1.2以上のすべてのバージョンで使用できます。すべてのXDK BeanはSun JavaBeans仕様に準拠し、java.beans.SimpleBeanInfo
を拡張する必須のBeanInfo
クラスが含まれます。
JDK 1.1のJavaBeansについて記述したJavaBeans 1.01仕様は、次のURLで入手できます。
http://www.oracle.com/technetwork/java/index.html
JavaBeansコア仕様にJava 2プラットフォームへの対応が追加され、より高度なJavaBeansコンポーネントを作成する標準手段が開発者に提供されました。Java 2のJavaBeans仕様は、次のURLで入手できます。
http://www.oracle.com/technetwork/java/index.html
Oracle XDK JavaBeansを使用すると、XMLアプリケーションにGUIを簡単に追加できます。Beanのカプセル化には、Oracle JDeveloperなどのJava IDEから直接アクセスできるドキュメントおよびディスクリプタが含まれます。
XDKに含まれるBeanは次のとおりです。
oracle.xml.async.DOMBuilder
Beanは、XML文書からDOMツリーを構築します。DOMBuilder
JavaBeanは、Beanインタフェースを使用してXML Parser for JavaのDOMParser
クラスをカプセル化し、機能を拡張して非同期解析をサポートします。リスナーを登録すると、Javaプログラムで大規模または連続したドキュメントの解析を開始し、制御をすぐにコール元に戻すことができます。
このBeanの大きなメリットの1つは、複数のファイルを解析する場合の効率の向上であり、ファイルが大きい場合は特に効果的です。DOMBuilder
は、対話式のビジュアル・アプリケーションのバックグラウンド・スレッドで、非同期解析を行うこともできます。非同期解析を行わない場合、ドキュメントの解析が終わるまでGUIを有効に使用できません。DOMBuilderを使用すると、解析メソッドをコールした後、アプリケーションに制御が戻ります。アプリケーションでは、プログレス・バーを表示したり、ユーザーが解析を取り消したりできます。
oracle.xml.async.XSLTransformer
Beanは、非同期変換をサポートします。これはXML文書を受け入れ、XSLTスタイルシートを適用し、出力ファイルを作成します。XSLTransformer
JavaBeanを使用すると、XML文書をXML、HTML、DDLなどのほぼすべてのテキストベースの形式に変換できます。このBeanは、サーバー側のアプリケーションまたはサーブレットがXML文書(問合せ結果のXML表現など)をブラウザで表示するためにHTMLでレンダリングするための基礎として使用できます。
XSLTransformer
Beanの主なメリットは、複数のファイルを同時に変換できることです。DOMBuilder
と同様に、このBeanをビジュアル・アプリケーションで使用すると、GUIが長い期間応答しなくなることを防止できます。XSLTransformerListenerインタフェースを実装すると、変換が完了したときにコール元のアプリケーションに通知されます。
oracle.xml.dbaccess.DBAccess
Beanは、複数のXML文書およびテキスト・ドキュメントを含むCLOB
表をメンテナンスします。このBeanは、データベース内でXML文書を処理する必要はないが、データベースにXML文書を格納し、データベースからXML文書を取得する必要がある場合に使用できます。DBAccess Beanを使用するJavaアプリケーションは、JDBCを介してデータベースに接続します。CLOB
表に格納されたXML文書がXMLType
型でない場合は、エンティティが展開されません。
DBAccess
Beanを使用すると、次のタスクを実行できます。
CLOB
型の表の作成および削除
CLOB
表の内容の問合せ
CLOB
表に格納されたXML文書に対するINSERT
、UPDATE
およびDELETE
操作の実行
oracle.xml.xmldbaccess.XMLDBAccess
Beanは、DBAccess
Beanを拡張してXMLType
表に格納されたXML文書をサポートします。このクラスは、XMLType
インスタンスおよびそれらの表を表示、削除または取得するメソッドを提供します。たとえば、getXMLXPathTextData()
メソッドは、XML文書からXPath式の値を取得します。
DBAccess
JavaBeanは、複数のXML文書およびテキスト・ドキュメントを保持できるXMLType
表をメンテナンスします。各XML文書またはテキスト・ドキュメントは、表の行として格納されます。表の作成には次のSQL文を使用します。
CREATE TABLE (FILENAME CHAR( ) UNIQUE, FILEDATA SYS.XMLType);
FILENAME
フィールドには、その行を検索、更新または削除するためにキーとして使用される一意の文字列があります。文書のテキストはFILEDATA
フィールドに格納されます。
XMLDBAccess
Beanが実行するタスクは次のとおりです。
XMLType
表の作成および削除
XMLType
列の内容の表示
XMLType
表に格納されたXML文書に対するINSERT
、UPDATE
およびDELETE
操作の実行
XML文書を比較する場合は、文字単位で比較しても通常は役に立ちません。XMLの比較は、空白の違いではなく、そのほとんどが構造や重要なテキスト・コンテンツの相違に関する比較です。oracle.xml.differ.XMLDiff
Beanは、次の有用なタスクを実行します。
2つの入力XML文書のDOMツリーを構築および比較して、それらの文書が異なるかどうかを示します。
2つのXMLファイルの差分をグラフィカルに表示します。具体的には、ノードの挿入、削除、変更または移動を目視できます。
入力XML文書の1つを他方の文書に変換できるXSLTスタイルシートを生成します。
XMLDiff
Beanは、特にパイプライン・アプリケーションで役立ちます。たとえば、アプリケーションでXML文書を更新し、前のバージョンの文書と比較し、それらの違いを示すXSLTスタイルシートを格納できます。
「XMLの圧縮」で説明しているように、Oracle XMLパーサーには、XML文書オブジェクトをバイナリ・ストリームとしてシリアライズできる圧縮プログラムが含まれます。便利なツールではありますが、XMLパーサーによる圧縮には次の短所があります。
XMLデータをデシリアライズしたとき、再解析が必要になります。
タグの中にXMLデータをカプセル化すると、サイズが大幅に増加します。
oracle.xml.xmlcomp.XMLCompress
Beanは、XML圧縮機能をカプセル化したものです。これを使用してXMLをシリアライズおよびデシリアライズすると、次の利点があります。
DOMをシリアライズするメソッドをカプセル化し、ストリーム形式にします。
XMLプロセッサは、XMLを再解析せずに圧縮ストリームからDOMを再生成できます。
このBeanは、DOMParser
またはSAXParser
によって解析された入力XMLの圧縮と解凍をサポートします。DOM圧縮は、XMLType
型、CLOB
型およびBLOB
型の入力をサポートします。
様々な解析オプションを使用するには、入力前に文書を解析してから、XMLDocument
オブジェクトをCompressor Beanに渡します。圧縮係数は、入力XMLファイルおよび圧縮したファイルのサイズに基づく大まかな値です。圧縮係数メソッドは、java.io.File
オブジェクトをパラメータとして使用して圧縮を行う場合にのみ使用できます。
oracle.xml.schemavalidator.XSDValidator
Beanは、XSDValidator
クラスをカプセル化し、DOMツリーの検証機能を追加します。このBeanの最も便利な機能の1つは、検証エラーに関する機能です。アプリケーションで検証エラーが発生すると、getStackList()
メソッドから、無効なノードを示すDOMツリー・パスのリストが戻ります。エラーのあるノードはスタック・ツリーのベクターに戻され、このスタックの最上位要素がルート・ノードに相当します。子ノードは、スタックから取り出して取得できます。getStackList()
を使用するには、java.util.Vector
クラスおよびjava.util.Stack
クラスのインスタンス化を使用する必要があります。
この項の内容は次のとおりです。
この項では、実用的なBean(DOMBuilder
、XSLTransformer
、XMLDBAccess
およびXMLDiff
)を使用するJavaアプリケーションのプログラム・フローについて説明します。この項の内容は次のとおりです。
DOMBuilder
クラスは、W3C勧告に準拠したXML 1.0のパーサーを実装します。XML文書を解析してDOMツリーを構築します。解析は別のスレッドで行われます。ツリーが構築されたときに通知されるようにするにはDOMBuilderListener
インタフェースを使用する必要があります。
このBeanを使用するアプリケーションを開発する場合、次のサブパッケージをインポートする必要があります。
oracle.xml.async
: DOMを構築するための非同期JavaBeansを提供します。
oracle.xml.parser.v2
: SAX、DOMおよびXSLTのAPIを提供します。
oracle.xml.parser.v2
サブパッケージの詳細は、第4章「XML Parsing for Java」を参照してください。表10-1
に、javax.xml.asyncパッケージの最も重要なDOM関連クラスおよびインタフェースを示します。
表10-1 javax.xml.asyncのDOM関連クラスおよびインタフェース
クラス/インタフェース | 説明 |
---|---|
|
XMLパーサーをカプセル化し、XML文書を解析してDOMツリーを構築します。解析は別のスレッドで行われます。ツリーが構築されたときに通知されるようにするには |
|
|
|
非同期解析時のイベントに関する通知をプログラムで受信できるようにするには、このインタフェースを実装する必要があります。 |
|
解析例外が発生したときに送信されるエラー・イベントを定義します。 |
|
解析中に検出されたエラーの通知をプログラムで受信できるようにするには、このインタフェースを実装する必要があります。 |
図10-1に、DOMBuilder
JavaBeanを使用するアプリケーションの基本プロセスを示します。
図10-1に示されたXML処理は次のとおりです。
入力XML文書を解析します。このプログラムはXML文書をファイル、文字列バッファまたはURLとして受け取ることができます。
DOMBuilder
リスナーを追加します。プログラムで、DOMBuilder.addDOMBuilderListener(DOMBuilderListener)
メソッドを起動します。
XML文書を解析します。プログラムで、DOMBuilder.parse()
メソッドを起動します。
オプションで、解析結果をさらに処理します。
プログラムが非同期コールを受信したとき、リスナーをコールします。このリスナーは、DOMBuilderListener
インタフェースを実装する必要があり、DOMBuilderOver()
メソッドの起動によってコールされます。
使用可能なDOMBuilderListener
メソッドは次のとおりです。
DOMをフェッチします。DOMBuilder.getDocument()
メソッドを起動して結果のDOM文書をフェッチし、出力します。
XSLTransformer
Beanは、Beanインタフェースを使用してJava XMLパーサーのXSLT処理エンジンをカプセル化し、その機能を拡張して非同期変換を可能にします。Javaアプリケーションは、リスナーを登録することによって、コール元にすぐに制御を返し、大規模または連続したドキュメントを解析できます。
このBeanを使用するアプリケーションを開発する場合、次のサブパッケージをインポートする必要があります。
oracle.xml.async
: XSLT変換のための非同期JavaBeansを提供します。
oracle.xml.parser.v2
: XMLを解析するSAX、DOMおよびXSLTのAPIを提供します。
oracle.xml.parser.v2
サブパッケージの詳細は、第4章「XML Parsing for Java」を参照してください。表10-2
に、javax.xml.asyncパッケージの最も重要なXSL関連クラスおよびインタフェースを示します。
表10-2 javax.xml.asyncのXSL関連クラスおよびインタフェース
クラス/インタフェース | 説明 |
---|---|
|
バックグラウンド・スレッドでXSLT変換を適用します。 |
|
|
|
非同期変換時のイベントに関する通知をプログラムで受信できるようにするには、このインタフェースを実装する必要があります。 |
|
|
|
非同期変換時のエラー・イベントに関する通知をプログラムで受信できるようにするには、このインタフェースを実装する必要があります。 |
図10-2に、XSLTransformer
Beanの使用方法を示します。
図10-2に示された処理は、次のとおりです。
XSLTスタイルシートとXMLインスタンス・ドキュメントを入力します。
XSLTリスナーを追加します。プログラムは、XSLTransfomer.addXSLTransformerListener()method
を起動します。
スタイルシートを適用します。XSLTransfomer.processXSL()
メソッドは、XSLT変換をバックグラウンドで開始します。
オプションで、XSLTransformer
Beanを使用してその他の処理を実行します。
プログラムが非同期コールを受信したとき、XSLTリスナーをコールします。このリスナーは、XSLTransformerListener
インタフェースを実装する必要があり、xslTransformerOver()
メソッドの起動によってコールされます。
変換結果をフェッチします。XSLTransformer.getResult()
メソッドを起動して、結果文書のXML文書フラグメントを戻します。
XML文書フラグメントを出力します。
XMLDBAccess
Beanを使用するアプリケーションを開発する場合、次のサブパッケージを使用する必要があります。
oracle.xml.xmldbaccess
: XMLDBAccess
Beanが含まれます。
oracle.xml.parser.v2
: XMLを解析するSAX、DOMおよびXSLTのAPIを提供します。
oracle.xml.parser.v2
サブパッケージの詳細は、第4章「XML Parsing for Java」を参照してください。表10-3
に、XMLDBAccessクラスの重要なメソッドを示します。
表10-3 XMLDBAccessのメソッド
クラス/インタフェース | 説明 |
---|---|
|
|
|
テキスト・ファイルを |
|
テキスト・ファイルを |
|
指定された文字列で開始する名前を持つXML表をすべて取得します。 |
|
|
|
XPath式に基づいて |
図10-3に、XMLDBAccess
Beanの一般的な使用方法を示します。これは、DBAccess
Beanを使用して、XMLType
で格納されたXML文書をメンテナンスおよび操作する方法です。
たとえば、XMLDBAccess
プログラムでは、次のようにXML文書を処理できます。
XMLType
表を作成します。データベース接続情報および表名を渡して、createXMLTypeTable()
を起動します。
XMLType
表のリストを作成します。データベース接続情報および空の文字列を渡して、getXMLTypeTableNames()
を起動します。
表にXMLデータをロードします。データベース接続情報、表名、XMLファイル名およびXMLを含む文字列を渡して、replaceXMLTypeData()
を起動します。
XMLデータをString
として取得します。接続情報、表名およびXMLファイル名を渡して、getXMLTypeData()
を起動します。
XPath式に基づいてXMLデータを取得します。接続情報、表名、XMLファイル名およびXPath式を渡して、getXMLXPathTextData()
を起動します。
接続を終了します。
XMLDiff
Beanを使用するアプリケーションを開発する場合、一般的に使用するサブパッケージは次のとおりです。
oracle.xml.xmldiff
: XMLDiff
Beanが含まれます。
oracle.xml.parser.v2
: XMLを解析するSAX、DOMおよびXSLTのAPIを提供します。
oracle.xml.async
: DOMを構築するための非同期JavaBeansを提供します。
oracle.xml.parser.v2
サブパッケージの詳細は、第4章「XML Parsing for Java」を参照してください。表10-4
に、XMLDiffクラスの重要なメソッドを示します。
表10-4 XMLDiffのメソッド
クラス/インタフェース | 説明 |
---|---|
|
2つの入力XMLファイルまたは2つのXMLDocumentオブジェクトの差分を検出します。 |
|
2つの入力XMLファイルの差分を表すXSLファイルを生成します。生成されたスタイルシートを使用して、最初のXMLファイルを2つ目のXMLファイルに変換できます。2つのXMLファイルが同じである場合は、生成されたXSLで最初のXMLファイルを2つ目のXMLファイルに変換でき、ここで最初のファイルと2つ目のファイルは同等です。 関連メソッドは、 |
|
比較する必要があるXMLファイルを設定します。 |
|
最初のXMLツリーのドキュメント・ルートをXMLDocumentオブジェクトとして取得します。 |
|
テキスト・パネルを、最初のXMLファイルの差分をビジュアルに表示する |
図10-4に、XMLDiff
Beanの一般的な使用方法を示します。これは、XMLDiff
Beanを使用して入力XML文書を比較し、差分を表示する方法です。
たとえば、XMLDiff
プログラムでは、次のようにXML文書を処理できます。
XMLDiff
オブジェクトを作成します。
比較するファイルを設定します。入力ファイルのFile
オブジェクトを作成し、XMLDiff.setFiles()
にオブジェクトへの参照を渡します。
ドキュメントを比較します。XMLファイルが同一の場合はdiff()
メソッドからfalse
が戻り、異なる場合はtrue
が戻ります。
入力XML文書が同一であるか異なるかに応じて対処します。たとえば、同一である場合は、JOptionPane.showMessageDialog()
を起動してメッセージを出力します。
入力XML文書の差分を示すXSLTスタイルシートを生成します。たとえば、generateXSLDoc()
は、XSLスタイルシートをXMLDocument
として生成します。
XMLDiff
によって作成されたDOMツリーを表示します。
XDK JavaBeansのデモ・プログラムは、$ORACLE_HOME/xdk/demo/java/transviewer
ディレクトリにあります。デモでは、「XDK JavaBeansの機能」で説明しているXDK Bean、および非推奨となった一部のビジュアルなBeanの使用方法を示します。デモで使用されているすべてのBeanを次に示します。
XSLTransformer
DOMBuilder
DBAccess
XMLDBAccess
XMLDiff
XMLCompress
XSDValidator
oracle.xml.srcviewer.XMLSourceView
(非推奨)
oracle.xml.treeviewer.XMLTreeView
(非推奨)
oracle.xml.transformer.XMLTransformPanel
(非推奨)
oracle.xml.dbviewer.DBViewer
(非推奨)
ビジュアルなBeanは非推奨ですが、学習用として役に立ちます。非推奨のBeanはそのために$ORACLE_HOME/lib/xmldemo.jar
に含まれています。推奨のBeanは$ORACLE_HOME/lib/xml.jar
にあります。
表10-5に、デモ・ディレクトリにあるサンプル・プログラムを示します。表の最初の列に、非推奨のBeanがどのサンプル・プログラムで使用されているかを示します。
表10-5 JavaBeanのサンプルJavaソース・ファイル
サンプル | ファイル名 | 説明 |
---|---|---|
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample1の実行」 |
(非推奨) |
|
このサンプルのビジュアル・アプリケーションでは、 関連項目: 「sample2の実行」 |
|
|
この非ビジュアル・アプリケーションでは、 関連項目: 「sample3の実行」 |
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample4の実行」 |
|
この |
|
|
この |
|
|
|
この非ビジュアル・アプリケーションでは、
関連項目: 「sample5の実行」 |
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample6の実行」 |
|
|
|
|
|
|
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample7の実行」 |
|
GUIの情報をBeanにパイプする単純なクラスです。このクラスは、 |
|
|
|
|
|
|
|
|
|
|
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample8の実行」 |
|
解析済のXMLインスタンス・ドキュメントをツリーとして表示する |
|
(非推奨) |
|
このビジュアル・アプリケーションでは、 関連項目: 「sample9の実行」 |
|
|
|
|
|
このアプリケーションは、 関連項目: 「sample10の実行」 |
表10-6に、デモ・プログラムで使用されるその他のファイルを示します。
表10-6 JavaBeanのサンプル・ファイル
ファイル名 | 説明 |
---|---|
|
|
|
|
|
このXML文書は、 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
サンプル・プログラムのコンパイル方法および実行方法は、同じディレクトリにあるREADME
に示されています。基本手順は次のとおりです。
ディレクトリを$ORACLE_HOME/xdk/demo/java/transviewer
ディレクトリ(UNIXの場合)または%ORACLE_HOME%\xdk\demo\java\transviewer
ディレクトリ(Windowsの場合)に変更します。
「Java XDK環境の設定」の説明に従って、環境変数が設定されていることを確認します。BeanにはJDK 1.2以上が必要です。HTMLをレンダリングするとき、DBViewer
BeanおよびDBTransformPanel
BeanにはJDK 1.2.2が必要です。これより前のバージョンのJDKでは、結果バッファのHTMLが適切にレンダリングされない場合があります。
使用する環境に応じて、Makefile
(UNIXの場合)またはMake.bat
(Windowsの場合)を編集します。具体的には、次の編集を行います。
Makefile
のJDKPATH
を、JDKパスを指すように変更します。
PATHSEP
を、オペレーティング・システムに合せて適切なパス・セパレータに変更します。
HOSTNAME
、PORT
、SID
、USERID
およびPASSWORD
パラメータを変更して、JDBCシン・ドライバを通じてデータベースに接続できるようにします。これらのパラメータは、sample4
およびsample5
で使用されます。
システム・プロンプトでmake
(UNIXの場合)またはMake.bat
(Windowsの場合)を実行して、クラス・ファイルを生成します。
次のようにgmake
を実行して、デモを実行します。
gmake sample1 gmake sample2 gmake sample3 gmake sample4 gmake sample5 gmake sample6 gmake sample7 gmake sample8 gmake sample9 gmake sample10
次の項では、デモの実行方法を説明します。
sample1
は、XMLTransViewer
Beanを使用するプログラムです。次のように手動でプログラムを実行できます。
java XMLTransformPanelSample
このプログラムを使用して、OracleデータベースのXMLファイルをインポートおよびエクスポートし、データベースにXSLT変換ファイルを格納し、XMLにスタイルシートを対話式に適用できます。このプログラムでデータベース接続機能を使用するには、データベースを実行しているコンピュータのネットワーク名、ポート(通常は1521
)およびOracleインスタンスの名前(通常はorcl
)を把握しておく必要があります。また、CREATE TABLE
権限を持つアカウントも必要です。サンプル・スキーマをインストールした場合は、アカウントhr
を使用できます。XMLTransViewer
プログラムを使用して、XMLファイルにスタイルシート変換を適用し、結果を表示できます。表示されるパネルの上部および下部にはタブがあります。上部にある最初の2つのタブは、XMLバッファとXSLTバッファの切替えに使用します。3つ目のタブでは、XMLバッファに対してXSLT変換を実行し、結果を表示します。下部にある最初の2つのタブを使用して、Oracleデータベースおよびファイル・システムのデータをロードおよび保存できます。下部の残りのタブでは、現在のコンテンツの表示をツリー表示、XMLソース、編集モードまたはHTML(変換後の結果の表示の場合)に切り替えます。
sample2
は、XMLSourceView
およびXMLTreeView
BeanのGUIベースのデモで、非推奨です。ViewSample
プログラムでは、booklist.xml
ファイルが、ソース表示とツリー表示に別々に示されます。次のように手動でプログラムを実行できます。
java ViewSample
sample3
は、非同期のDOMBuilder
BeanおよびXSLTransformer
Beanの非ビジュアルなデモです。AsyncTransformSample
プログラムは、現在のディレクトリ内のすべての*.xml
ファイルにdoc.xsl
XSLTスタイルシートを適用します。結果は、拡張子が.log
であるファイルに書き込まれます。次のようにプログラムを実行できます。
java AsyncTransformSample
sample4
はDBViewer
Beanのビジュアルなデモで、非推奨です。これは、次のように実行されます。
SQL*Plusを起動し、Makefile
で指定されたUSERID
およびPASSWORD
を使用してデータベースに接続し、claim.sql
スクリプトを実行します。このスクリプトは、DBViewSample
デモ・プログラムで使用する多数の表、ビューおよび型を作成します。
DBViewSampleプログラムを次のように実行します。
java -classpath "$(MAKE_CLASSPATH)" DBViewSample
JDBC接続情報は、デモで使用されるクラスを実装するDBViewClaims.java
ソース・ファイルにハードコードされています。特に、USERID
、PASSWORD
およびその他の値は、Makefile
に設定された値であることが前提になっています。使用する構成が異なる場合は、DBViewClaims.java
の92行にナビゲートし、setUsername()
、setPassword()
およびその他を現在のOracleデータベース構成を反映した値に変更します。
Sample5
は、XMLDBAccess
Beanの非ビジュアルなデモです。XMLTypeオブジェクトを使用して、データベースの中にXML文書を格納します。次のプログラムは、Javaシン・クライアントを使用してデータベースに接続し、XMLType
表を作成し、booklist.xml
からデータをロードします。このプログラムを実行するには、次の情報をコマンドライン引数として指定する必要があります。
ホスト名(たとえば、myhost
)
ポート番号(たとえば、1521
)
データベースのSID(たとえば、ORCL
)
表を作成するためのデータベース・アカウント(たとえば、hr
)
データベース・アカウントのパスワード(たとえば、hr
)
たとえば、次のようにプログラムを実行できます。
java XMLDBAccessSample myhost 1521 ORCL hr hr
次のテキストは、dbaccess.log
からのサンプル出力です。
Demo for createXMLTypeTables(): Table +'testxmltype' successfully created. Demo for listXMLTypeTables(): tablenamename=TESTXMLTYPE Demo for replaceXMLTypeData() (similar to insert): XML Data from +'booklist.xml' successfully replaced in table 'testxmltype'. Demo for getXMLTypeData(): XMLType data fetched: <?xml version="1.0"?> <booklist> <book isbn="1234-123456-1234"> <title>C Programming Language</title> <author>Kernighan and Ritchie</author> <publisher>EEE</publisher> <price>7.99</price> </book> ... <book isbn="1230-23498-2349879"> <title>Emperor's New Mind</title> <author>Roger Penrose</author> <publisher>Oxford Publishing Company</publisher> <price>15.99</price> </book> </booklist> Demo for getXMLTypeXPathTextData(): Data fetched using XPath exp '/booklist/book[3]': <book isbn="2137-598354-65978"> <title>Twelve Red Herrings</title> <author>Jeffrey Archer</author> <publisher>Harper Collins</publisher> <price>12.95</price> </book>
sample6
プログラムは、XMLDiff
Beanのビジュアルなデモです。XMLDiffSample
クラスによってGUIが起動され、XMLファイルの比較を選択すると、「ファイル」メニューから入力データ・ファイルを選択できます。「変換」メニューを使用して、生成されたXSLTを最初の入力XMLに適用できます。「ファイル」メニューの「別名保存」を選択して、出力XMLファイルを保存します。このファイルは、2つ目の入力ファイルと同じになります。デフォルトでは、XMLDiffData1.txt
がXMLDiffData2.txt
と比較され、XSLT出力がXMLDiffSample.xsl
として格納されます。
次のように手動でプログラムを実行できます。
java -mx50m XMLDiffSample XMLDiffData1.txt XMLDiffData2.txt
ファイアウォールの外側のURLにアクセスするDTDを入力XMLファイルで使用する場合は、XMLDiffSample.java
を変更して、setFiles()
コールの前にプロキシ・サーバーの設定を含めます。たとえば、次のようにプログラムを変更します。
/* Set proxy to access dtd through firewall */ Properties p = System.getProperties(); p.put("proxyHost", "www.proxyservername.com"); p.put("proxyPort", "80"); p.put("proxySet", "true"); /* You will also have to import java.util.*; */
sample7
は、XMLCompress
Beanの使用方法を示すビジュアルなデモです。compviewer
クラスを使用すると、GUIを起動して、XMLファイルおよびデータベースから取得したデータを圧縮および解凍できます。ロード・オプションにより、データをファイル・システムまたはデータベースから取得できます。このアプリケーションでは、データベースからの圧縮データのロードおよび保存はサポートされません。圧縮係数は、XMLデータの圧縮率を示す大まかな値です。
次のように手動でプログラムを実行できます。
java compviewer
sample8
のデモは、XMLTreeViewer
Beanの使用方法を示します。XMLSchemaTreeViewer
プログラムを使用すると、XMLDocument
をツリー形式で表示できます。スキーマ・ドキュメントを入力することで、インスタンス・ドキュメントをスキーマに対して検証できます。ドキュメントが無効な場合は、無効なノードがハイライト表示され、エラー・メッセージが表示されます。また、すべてのライン情報のログが専用のパネルに表示され、このパネルを使用してインスタンス・ドキュメントを編集および再評価できます。サンプル・ファイルpurchaseorder.xml
およびpurchaseorder.xsd
を使用して、このプログラムをテストします。インスタンス・ドキュメントpurchaseorder.xml
は、purchaseorder.xsd
で定義されたスキーマに準拠していません。
次のように手動でプログラムを実行できます。
java XMLSchemaTreeViewer
sample9
のデモは、SourceViewer
Beanの使用方法を示します。XMLSrcViewer
プログラムでは、構文のハイライト表示を有効にしてXML文書またはDTDを表示できます。入力したXMLスキーマまたはDTDに対してXML文書を検証できます。内部または外部のDTDを使用できます。
検証が成功した場合は、「ソース表示」ペインでインスタンス・ドキュメントおよびXMLスキーマまたはDTDを表示できます。スキーマ検証でエラーが検出された場合は、「エラー」ペインにエラー・ログと行番号が表示されます。「ソース表示」ペインには、エラー・ノードがハイライトされた状態でXML文書が表示されます。サンプル・ファイルpurchaseorder.xml
およびpurchaseorder.xsd
をは、XMLスキーマ検証のエラーをテストするために使用できます。note_in_dtd.xml
をDTD検証モードで使用すると、検証エラーとともに内部DTDを表示できます。次のように手動でプログラムを実行できます。
java XMLSrcViewer
sample10
のデモは、XSDValidator
Beanの使用方法を示します。XSDValidatorSample
プログラムの2つの入力引数は、XML文書とその関連XMLスキーマです。このプログラムでは、検証中に発生したエラーが、行番号を含めて表示されます。
次のプログラムでは、purchaseorder.xsd
を使用してpurchaseorder.xml
の内容を検証します。
java XSDValidatorSample purchaseorder.xml purchaseorder.xsd
このXML文書は、スキーマ検証で失敗します(予定どおりの動作)。次のエラーが表示されます。
Sample purchaseorder.xml purchaseorder.xsd <Line 2, Column 41>: XML-24523: (Error) Invalid value 'abc' for attribute: 'orderDate' #document->purchaseOrder <Line 7, Column 27>: XML-24525: (Error) Invalid text 'CA' in element: 'state' #document->purchaseOrder->shipTo->state->#text <Line 8, Column 25>: XML-24525: (Error) Invalid text 'sd' in element: 'zip' #document->purchaseOrder->shipTo->zip->#text <Line 14, Column 27>: XML-24525: (Error) Invalid text 'PA' in element: 'state' #document->purchaseOrder->billTo->state->#text <Line 17, Column 22>: XML-24534: (Error) Element 'coment' not expected. #document->purchaseOrder->coment <Line 29, Column 31>: XML-24534: (Error) Element 'shipDae' not expected. #document->purchaseOrder->items->item->shipDae
この項の内容は次のとおりです。
「DOMBuilder」および「XSLTransformer」で説明したように、XDK Beanを使用して非同期XML処理を実行できます。
AsyncTransformSample.java
プログラムは、DOMBuilder
およびXSLTransformer
の両方のBeanの使用方法を示します。このプログラムは次のメソッドを実装します。
runDOMBuilders()
runXSLTransformer()
saveResult()
makeXSLDocument()
createURL()
init()
exitWithError()
asyncTransform()
プログラムの基本的なアーキテクチャは次のとおりです。
このプログラムは、クラスで使用されるフィールドを宣言および初期化します。入力XSLTスタイルシートは、doc.xsl
としてプログラムにハードコードされています。クラスでは次のフィールドを定義します。
String basedir = new String ("."); OutputStream errors = System.err; Vector xmlfiles = new Vector(); int numXMLDocs = 1; String xslFile = new String ("doc.xsl"); URL xslURL; XMLDocument xsldoc
main()
メソッドがinit()
メソッドを起動して初期設定が実行されます。現在のディレクトリ内のファイルがリストされ、拡張子.xml
で終わるファイルが見つかった場合は、Vector
オブジェクトに追加されます。init()
メソッドの実装は次のとおりです。
boolean init () throws Exception { File directory = new File (basedir); String[] dirfiles = directory.list(); for (int j = 0; j < dirfiles.length; j++) { String dirfile = dirfiles[j]; if (!dirfile.endsWith(".xml")) continue; xmlfiles.addElement(dirfile); } if (xmlfiles.isEmpty()) { System.out.println("No files in directory were selected for processing"); return false; } numXMLDocs = xmlfiles.size(); return true; }
main()
メソッドは次のようにAsyncTransformSample
をインスタンス化します。
AsyncTransformSample inst = new AsyncTransformSample();
main()
メソッドがasyncTransform()
メソッドを起動します。asyncTransform()
メソッドの主なタスクは次のとおりです。
makeXSLDocument()
を起動して入力XSLTスタイルシートを解析します。
runDOMBuilders()
をコールして、インスタンス・ドキュメント(変換されるドキュメント)の解析を開始し、解析後にドキュメントを変換します。
XMLの処理が開始すると、プログラムに制御が戻り、バックグラウンドで処理が実行されるまで待機します。最後のリクエストが完了すると、メソッドが終了します。
次のコードは、asyncTransform()
メソッドの実装を示します。
void asyncTransform () throws Exception { System.err.println (numXMLDocs + " XML documents will be transformed" + " using XSLT stylesheet specified in " + xslFile + " with " + numXMLDocs + " threads"); makeXSLDocument (); runDOMBuilders (); // wait for the last request to complete while (rm.activeFound()) Thread.sleep(100); }
次の項では、makeXSLDocument()
メソッドおよびrunDOMBuilders()
メソッドについて説明します。
makeXSLDocument()
メソッドは、入力スタイルシートの簡単なDOM解析を示します。非同期解析は使用しません。使用する解析方法は、「基本的なDOM解析の実行」で説明している方法と同じです。
メソッドは次の手順を実行します。
新規DOMParser()
オブジェクトを作成します。DOMSample.java
の次のコード部分は、この方法を示します。
DOMParser parser = new DOMParser();
パーサーを構成します。次のコード部分は、空白の保持を指定します。
parser.setPreserveWhitespace(true);
入力スタイルシートからURL
オブジェクトを作成します。次のコード部分は、このタスクを実行するためにcreateURL()
ヘルパー・メソッドを起動します。
xslURL = createURL (xslFile);
入力XSLTスタイルシートを解析します。この方法を示す文は次のとおりです。
parser.parse (xslURL);
インメモリーDOMツリーのルートへのハンドルを取得します。XMLDocument
オブジェクトを使用して、解析済XML文書のすべての部分にアクセスできます。この方法を示す文は次のとおりです。
xsldoc = parser.getDocument();
runDOMBuilders()
メソッドは、DOMBuilder
BeanおよびXSLTransformer
Beanを使用して非同期処理を実行する方法を示します。XMLの解析および変換は、バックグラウンドで実行されます。
メソッドは次の手順を実行します。
入力XML文書を管理するリソース・マネージャを作成します。for
ループが作成され、XML文書が取得されます。次のコード部分は、この方法を示します。
rm = new ResourceManager (numXMLDocs); for (int i = 0; i < numXMLDocs; i++) { rm.getResource(); ... }
入力XML文書ごとにDOMビルダーBeanをインスタンス化します。次に例を示します。
DOMBuilder builder = new DOMBuilder(i);
XMLファイル名からURL
オブジェクトを作成します。次に例を示します。
DOMBuilder builder = new DOMBuilder(i); URL xmlURL = createURL(basedir + "/" + (String)xmlfiles.elementAt(i)); if (xmlURL == null) exitWithError("File " + (String)xmlfiles.elementAt(i) + " not found");
DOMビルダーを構成します。次のコード部分は、空白の保持を指定し、文書のベースURLを設定します。
builder.setPreserveWhitespace(true); builder.setBaseURL (createURL(basedir + "/"));
DOMビルダーのリスナーを追加します。addDOMBuilderListener()
を起動することで、リスナーが追加されます。
リスナーの作成のためにインスタンス化されるクラスは、DOMBuilderListener
インタフェースを実装する必要があります。プログラムでは、domBuilderStarted()
およびdomBuilderError()
には何も処理が実装されませんが、XML文書の解析が完了したときにコールされるdomBuilderOver()
メソッドには、実際に処理を行う実装が必要です。このメソッドは、XMLの変換を行うrunXSLTransformer()
メソッドを起動します。このメソッドの詳細は、「XSLTransformer BeanによるXMLの変換」を参照してください。
次のコード部分は、リスナーを追加する方法を示します。
builder.addDOMBuilderListener ( new DOMBuilderListener() { public void domBuilderStarted(DOMBuilderEvent p0) {} public void domBuilderError(DOMBuilderEvent p0) {} public synchronized void domBuilderOver(DOMBuilderEvent p0) { DOMBuilder bld = (DOMBuilder)p0.getSource(); runXSLTransformer (bld.getDocument(), bld.getId()); } } );
DOMビルダーのエラー・リスナーを追加します。addDOMBuilderErrorListener()
を起動することで、リスナーが追加されます。
リスナーの作成のためにインスタンス化されるクラスは、DOMBuilderErrorListener
インタフェースを実装する必要があります。次のコード部分は、実装方法を示します。
builder.addDOMBuilderErrorListener ( new DOMBuilderErrorListener() { public void domBuilderErrorCalled(DOMBuilderErrorEvent p0) { int id = ((DOMBuilder)p0.getSource()).getId(); exitWithError("Error occurred while parsing " + xmlfiles.elementAt(id) + ": " + p0.getException().getMessage()); } } );
ドキュメントを解析します。この方法を示す文は次のとおりです。
builder.parse (xmlURL); System.err.println("Parsing file " + xmlfiles.elementAt(i));
DOM解析が完了すると、DOMリスナーは通知を受信します。domBuilderOver()
メソッドは、このイベントに応答するための動作を実装します。プログラムからrunXSLTransformer()
メソッドにDOMを渡すことで、XSLT変換を開始します。
メソッドは次の手順を実行します。
XSLTransformer
Beanをインスタンス化します。このオブジェクトは、XSLT処理を実行します。この方法を示す文は次のとおりです。
XSLTransformer processor = new XSLTransformer (id);
新規スタイルシート・オブジェクトを作成します。次に例を示します。
XSLStylesheet xsl = new XSLStylesheet (xsldoc, xslURL);
XSLTプロセッサを構成します。たとえば、次の文は、警告を表示するようにプロセッサを設定し、エラー出力ストリームを構成します。
processor.showWarnings (true); processor.setErrorStream (errors);
XSLTプロセッサのリスナーを追加します。プログラムからaddXSLTransformerListener()
を起動することで、リスナーが追加されます。
リスナーの作成のためにインスタンス化されるクラスは、XLSTransformerListener
インタフェースを実装する必要があります。プログラムでは、xslTransformerStarted()
およびxslTransformerError()
には何も処理が実装されませんが、XML文書の解析が完了したときにコールされるxslTransformerOver()
メソッドには、実際に処理を行う実装が必要です。このメソッドは、変換結果をファイルに出力するsaveResult()
を起動します。
次のコード部分は、リスナーを追加する方法を示します。
processor.addXSLTransformerListener ( new XSLTransformerListener() { public void xslTransformerStarted (XSLTransformerEvent p0) {} public void xslTransformerError(XSLTransformerEvent p0) {} public void xslTransformerOver (XSLTransformerEvent p0) { XSLTransformer trans = (XSLTransformer)p0.getSource(); saveResult (trans.getResult(), trans.getId()); } } );
XSLTプロセッサのエラー・リスナーを追加します。プログラムからaddXSLTransformerErrorListener()
を起動することで、リスナーが追加されます。
リスナーの作成のためにインスタンス化されるクラスは、XLSTransformerErrorListener
インタフェースを実装する必要があります。次のコード部分は、実装方法を示します。
processor.addXSLTransformerErrorListener ( new XSLTransformerErrorListener() { public void xslTransformerErrorCalled(XSLTransformerErrorEvent p0) { int i = ((XSLTransformer)p0.getSource()).getId(); exitWithError("Error occurred while processing " + xmlfiles.elementAt(i) + ": " + p0.getException().getMessage()); } } );
XSLTスタイルシートを使用してXML文書を変換します。この方法を示す文は次のとおりです。
processor.processXSL (xsl, xml);
「XMLDiff」で説明しているように、XDK Beanを使用してXML文書の構造および重要なコンテンツを比較できます。
XMLDiffSample.java
プログラムは、XMLDiff
Beanの使用方法を示します。このプログラムは次のメソッドを実装します。
showDiffs()
doXSLTransform()
createURL()
プログラムの基本的なアーキテクチャは次のとおりです。
このプログラムは、クラスで使用されるフィールドを宣言および初期化します。XMLDiffFrame
型のフィールドが1つあります。これはXMLDiffFrame.java
デモで実装されるクラスです。クラスでは次のフィールドを定義します。
protected XMLDocument doc1; /* DOM tree for first file */ protected XMLDocument doc2; /* DOM tree for second file */ protected static XMLDiffFrame diffFrame; /* GUI frame */ protected static XMLDiffSample dfxApp; /* XMLDiff sample application */ protected static XMLDiff xmlDiff; /* XML diff object */ protected static XMLDocument xslDoc; /* parsed xsl file */ protected static String outFile = new String("XMLDiffSample.xsl"); /* output xsl file name */
main()
メソッドが次のようにXMLDiffSample
オブジェクトを作成します。
dfxApp = new XMLDiffSample();
main()
メソッドが、比較の結果を表示するためのJFrame
を追加および初期化します。この方法を示すコードは次のとおりです。
diffFrame = new XMLDiffFrame(dfxApp); diffFrame.addTransformMenu();
main()
メソッドがXMLDiff
Beanをインスタンス化します。この方法を示すコードは次のとおりです。
xmlDiff = new XMLDiff();
main()
メソッドがshowDiffs()
メソッドを起動します。このメソッドは、次のタスクを実行します。
XMLDiff.diff()
を起動して、入力XML文書を比較します。
入力文書の1つを他の文書に変換できるXSLTスタイルシートを生成し、表示します。
次のコード部分は、showDiffs()
メソッド・コールを示します。
if (args.length == 3) outFile = args[2]; if(args.length >= 2) dfxApp.showDiffs(new File(args[0]), new File(args[1])); diffFrame.setVisible(true);
次の項では、showDiffs()
メソッドについて説明します。
showDiffs()
メソッドは、XMLDiff
Beanの使用方法を示します。
メソッドは次の手順を実行します。
XMLDiff
プロセッサに対してファイルを設定します。この方法を示す文は次のとおりです。
xmlDiff.setFiles(file1, file2);
ファイルを比較します。diff()
メソッドは、入力文書の構造および内容が同一であるかどうかを示すブール値を戻します。同一である場合は、XMLDiffFrame
クラスで実装されたJFrame
にメッセージが出力されます。次のコード部分は、この方法を示します。
if(!xmlDiff.diff()) { JOptionPane.showMessageDialog ( diffFrame, "Files are equivalent in XML representation", "XMLDiffSample Message", JOptionPane.PLAIN_MESSAGE ); }
2つのドキュメントの差分を示すXSLTスタイルシート用にDOMを生成します。次のコード部分は、この方法を示します。
xslDoc = xmlDiff.generateXSLDoc();
XMLDiffFrame
で実装されたJFrame
にドキュメントを表示します。XMLSourceView
Beanをインスタンス化するXMLDiffFrame
は、非推奨です。メソッドは次の手順を実行します。
入力ドキュメントのためのソース・ペインを作成します。次に示すように、diffFrame
オブジェクトに2つのドキュメントのDOMハンドルを渡して、ソース・ペインを作成します。
diffFrame.makeSrcPane(xmlDiff.getDocument1(), xmlDiff.getDocument2());
ドキュメントの差分を表示するペインを作成します。次に示すように、テキスト・ペインへの参照をdiffFrame
に渡します。
diffFrame.makeDiffSrcPane(new XMLDiffSrcView(xmlDiff.getDiffPane1()), new XMLDiffSrcView(xmlDiff.getDiffPane2()));
XSLTスタイルシートのペインを作成します。次に示すように、スタイルシートのDOMを渡します。
diffFrame.makeXslPane(xslDoc, "Diff XSL Script"); diffFrame.makeXslTabbedPane();