11 Oracle XML Developer's Kit for Javaの開始
XDK for Javaの使用を開始する方法について説明します。
11.1 XDK for Javaコンポーネントのインストール
XDK for Javaコンポーネントは、Oracle Databaseに付属しています。この章では、Oracle DatabaseとともにXDKをインストールし、Oracle Database Examplesメディアからデモ・プログラムをインストールしたと想定します。
注意:
Oracle XML Developer's Kit (XDK)のコンポーネントを使用してソフトウェア・プログラムを構築すると、外部エンティティ拡張や再帰的拡張など、強力だが危険を伴う可能性のある機能が使用可能になります。XDKを安全に使用する方法の詳細は、「Oracle XML Developer's Kitのセキュリティ上の考慮事項」を参照してください。
XDKディレクトリ構造の詳細は、「XDKのインストールについて」を参照してください。
例11-1に、Java用のOracleホーム・ディレクトリ下の主なディレクトリを示します(これは、UNIXディレクトリ構造です)。サブディレクトリの内容は、例の後に個々に示します。
bin
ディレクトリには、次のコンポーネントが含まれます。
orajaxb orapipe oraxml oraxsl transx
lib
ディレクトリには、次のJARファイルおよびZIPファイルが含まれます。
classgen.jar jdev-rt.zip oraclexsql.jar transx.zip xml.jar xml2.jar xmldemo.jar xmlmesg.jar xmlparserv2.jar xschema.jar xsqlserializers.jar xsu12.jar
jlib
ディレクトリには、次のJARファイルが含まれます。
orai18n.jar orai18n-collation.jar orai18n-mapping.jar orai18n-utility.jar
jdbc
ディレクトリには、次のlib
サブディレクトリが含まれます。
| - lib/ ojdbc6.jar
rdbms
ディレクトリには、次のjlib
サブディレクトリが含まれます。
| - jlib/ xdb.jar
また、xdk
ディレクトリには、次のdemo
サブディレクトリが含まれます。
| demo/ | - java/ | - classgen/ | - jaxb/ | - parser/ | - pipeline/ | - schema/ | - transviewer/ | - tranxs/ | - xsql/ | - xsu/
/xdk/demo/java
サブディレクトリには、XDK for Javaコンポーネントのサンプル・プログラムとデータ・ファイルが含まれます。「Oracle XML Developer's Kit for Java」の章では、これらのプログラムを使用して最も重要なJavaの機能を学習する方法について説明します。
関連項目:
表1-1では、個々のXDK for Javaコンポーネントについて説明します。
例11-1 Oracle XML Developer's Kit for Javaのライブラリ、ユーティリティおよびデモ
- $ORACLE_HOME | - bin/ | - lib/ | - jlib/ | - jdbc/ | - rdbms/ | - xdk/
11.2 XDK for Javaコンポーネントの依存性
Java Development Kit (JDK)を使用する場合のXDK for Javaコンポーネントの依存性について説明します。
XDK for Javaコンポーネントは、JDKバージョン5および6で動作保証およびサポートされています。それより前のJavaはサポートが終了しました。図11-1に、JDK 5を使用する場合のXDK for Javaコンポーネントの依存性を示します。
図11-1 JDK 5の場合のOracle XML Developer's Kit for Javaコンポーネントの依存性
![図11-1の説明が続きます 図11-1の説明が続きます](img/adxdk110.gif)
「図11-1 JDK 5の場合のOracle XML Developer's Kit for Javaコンポーネントの依存性」の説明
XDK for Javaコンポーネントには、表11-1のライブラリが必要です。一部のライブラリはXDKに固有ではなく、他のOracle Databaseコンポーネント間で共有されます。
表11-1 Oracle XML Developer's Kit for JavaコンポーネントのJavaライブラリ
ライブラリ | ディレクトリ | 内容 . . . |
---|---|---|
|
|
Javaランタイム・クラス用Extensible Markup Language (XML) Class Generator。 注意: このライブラリは、下位互換性のみを目的として保持されています。かわりに、 |
|
|
Java Development Environment (JDE)でデモを利用する際に使用するJavaグラフィカル・インタフェース(GUI)。 |
|
|
Java 6用Oracle Java Database Connectivity (JDBC)ドライバ。このJava Archive (JAR)では、8ビット・エンコーディングのUnicode (UTF-8)、ISO8859-1またはJA16SJIS以外のマルチバイト・キャラクタ・セットを使用する場合、キャラクタ・セット・サポートは |
|
|
XSQLページの作成に必要なXSQLサーブレット・クラスの大部分。 注意: このJARは |
|
|
JDK 1.2以上に対するグローバリゼーション・サポート。これは、他のすべてのグローバリゼーションJARのラッパーであり、キャラクタ・セット・コンバータを含みます。UTF-8、ISO8859-1またはJA16SJIS以外のマルチバイト・キャラクタ・セットを使用する場合は、XML SQL Utility (XSU)、TransX Utility、XSQLサーブレットのいずれかを使用したXMLファイルのロード中にJDBCが入力ファイルのキャラクタ・セットをデータベースキャラクタ・セットに変換できるように、このアーカイブを |
|
|
グローバリゼーション照合機能: |
|
|
グローバリゼーション・ロケールとキャラクタ・セット名のマッピング: |
|
|
グローバリゼーション・ロケール・オブジェクト: |
|
|
TransX Utilityクラス。 注意: このアーカイブは |
|
|
|
|
|
JAXBおよびパイプライン・プロセッサ・クラス、および次のライブラリのクラス。
|
|
|
ビジュアルなJavaBeans: |
|
|
XMLパーサーを英語以外の言語で使用する場合のサポート。 |
|
|
次のもののアプリケーション・プログラミング・インタフェース。
このライブラリには |
|
|
注意: このJARファイルは、下位互換性のみを目的として保持されています。 |
|
|
XSQLサーブレットでPDFなどのシリアライズされた出力に必要なクラス。 注意: このアーカイブは |
|
|
XSUを実装するクラス。これらのクラスでは、 |
関連項目:
-
グローバリゼーション・サポート・ライブラリの詳細は、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください
-
JDBCライブラリの詳細は、『Oracle Database JDBC開発者ガイド』を参照してください
-
Oracle XML DBの詳細は、『Oracle XML DB開発者ガイド』を参照してください
11.3 XDK for Java環境の設定
XDK for Java環境は、環境変数またはコマンドライン・オプションを使用して設定できます。
XDK for Java環境を設定するには、次のいずれかを行います。
-
XDKのOracle Databaseインストール時、環境変数
$CLASSPATH
(UNIX)または%CLASSPATH%
(Windows)を手動で設定します。 -
コマンドラインでJavaプログラムをコンパイルおよび実行する際に
-classpath
オプションを設定します。
11.3.1 UNIXでのXDK for Java環境変数の設定
XDK for Javaコンポーネントに必要なUNIX環境変数について説明します。
表11-2 Oracle XML Developer's Kit for JavaコンポーネントのUNIX環境変数
変数 | 説明 |
---|---|
|
次のものが含まれます。
注意: 現在のディレクトリを表すピリオド(.)はオプションです。 |
|
JDK 5の場合、次のように設定します。
特定のキャラクタ・セットには |
|
Java JDK, Standard Editionのインストール・ディレクトリ。Java SDKにリンクするパスを変更します。 |
|
OCI/JDBC接続用:
|
|
|
UNIXでのXDK for Java環境の設定後、表11-3に説明するコマンドライン・ユーティリティを使用できます。
表11-3 Oracle XML Developer's Kit for Java UNIXユーティリティ
実行可能ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このスクリプトは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
11.3.2 UNIXでのXDK for Java環境のテスト
XDK Java環境をテストするためのUNIXシェル・スクリプトが用意されています。
例11-2 UNIXでのOracle XML Developer's Kit for Java環境のテスト
#!/usr/bin/tcsh
echo;echo "BEGIN TESTING";echo
echo;echo "now testing the XSQL utility...";echo
xsql
echo; echo "now testing the XSU utility...";echo
java OracleXML
echo;echo "now testing the JAXB utility...";echo
orajaxb -version
echo;echo "now testing the Pipeline utility...";echo
orapipe -version
echo;echo "now testing the XSLT Processor utility...";echo
oraxsl
echo;echo "now testing the TransX utility...";echo
transx
echo;echo "END TESTING"
11.3.3 WindowsでのXDK for Java環境変数の設定
XDK for Javaコンポーネントに必要なMicrosoft Windows環境変数について説明します。
表11-4に、XDK for Javaコンポーネントに必要なWindows環境変数を示します。
表11-4 Oracle XML Developer's Kit for JavaコンポーネントのWindows環境変数
変数 | 説明 |
---|---|
|
次のものが含まれます。
注意: 現在のディレクトリを表すシングル・ピリオド"."は必須ではありませんが、役に立つ場合があります。 |
|
JDK 5の場合、次のように設定します。
特定のキャラクタ・セットをサポートするには、 |
|
Java Software Developer's Kit (SDK), Standard Editionのインストール・ディレクトリ。Java SDKにリンクするパスを変更します。 |
|
|
WindowsでのXDK for Java環境の設定後、表11-5に説明するコマンドライン・ユーティリティを使用できます。
表11-5 Oracle XML Developer's Kit for Java Windowsユーティリティ
バッチ・ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このバッチ・ファイルは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
11.4 XDK (Java)バージョンの確認
javac
を使用して、使用しているXDKバージョンを確認できます。
インストールしたXDKのバージョンを確認するには、javac
を使用して、例11-4に示すJavaコードをコンパイルします。
コンパイル後、オペレーティング・システムのコマンドラインで次のようにしてプログラムを実行します。
java XDKVersion
結果は次のようになります。
You are using version: Oracle XML Developers Kit 11.1.0.6.0 - Production
例11-4 XDKVersion.java
// // XDKVersion.java // import java.net.URL; import oracle.xml.parser.v2.XMLParser; public class XDKVersion { static public void main(String[] argv) { System.out.println("You are using version: "); System.out.println(XMLParser.getReleaseVersion()); } }