この章では、Oracle XML Developer's Kit (XDK) for Javaを使用するための準備について説明します。
内容は次のとおりです。
XDK for Javaコンポーネントは、Oracle Databaseに付属しています。この章では、Oracle DatabaseとともにXDKをインストールし、Oracle Database Examplesメディアからデモ・プログラムをインストールしたと想定します。XDKディレクトリ構造の詳細は、「XDKのインストール」を参照してください。
例3-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コンポーネントについて説明します。
例3-1 Oracle XML Developer's Kit for Javaのライブラリ、ユーティリティおよびデモ
- $ORACLE_HOME | - bin/ | - lib/ | - jlib/ | - jdbc/ | - rdbms/ | - xdk/
XDK for Javaコンポーネントは、Java Development Kit (JDK)バージョン5および6で動作保証およびサポートされています。それより前のJavaはサポートが終了しました。図3-1に、JDK 5を使用する場合のXDK for Javaコンポーネントの依存性を示します。
図3-1 JDK 5の場合のOracle XML Developer's Kit for Javaコンポーネントの依存性
XDK for Javaコンポーネントには、表3-1のライブラリが必要です。一部のライブラリはXDKに固有ではなく、他のOracle Databaseコンポーネント間で共有されます。
表3-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を実装するクラス。これらのクラスでは、 |
関連項目:
Globalization Supportライブラリの詳細は、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。
JDBCライブラリの詳細は、『Oracle Database JDBC開発者ガイド』を参照してください。
Oracle XML DBの詳細は、『Oracle XML DB開発者ガイド』を参照してください。
XDK for Java環境を設定するには、次のいずれかを行います。
XDKのOracle Databaseインストール時、環境変数$CLASSPATH
(UNIX)または%CLASSPATH%
(Windows)を手動で設定します。
コマンドラインでJavaプログラムをコンパイルおよび実行する際に-classpath
オプションを設定します。
内容は次のとおりです。
表3-2に、XDK for Javaコンポーネントに必要なUNIX環境変数を示します。
表3-2 Oracle XML Developer's Kit for JavaコンポーネントのUNIX環境変数
変数 | 説明 |
---|---|
|
次のものが含まれます。
注意: 現在のディレクトリを表すピリオド(.)はオプションです。 |
|
JDK 5の場合、次のように設定します。
特定のキャラクタ・セットには |
|
Java JDK, Standard Editionのインストール・ディレクトリ。Java SDKにリンクするパスを変更します。 |
|
OCI/JDBC接続用:
|
|
|
UNIXでのXDK for Java環境の設定後、表3-3に説明するコマンドライン・ユーティリティを使用できます。
表3-3 Oracle XML Developer's Kit for Java UNIXユーティリティ
実行可能ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このスクリプトは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
例3-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"
表3-4に、XDK for Javaコンポーネントに必要なWindows環境変数を示します。
表3-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環境の設定後、表3-5に説明するコマンドライン・ユーティリティを使用できます。
表3-5 Oracle XML Developer's Kit for Java Windowsユーティリティ
バッチ・ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このバッチ・ファイルは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
インストールしたXDKのバージョンを確認するには、javac
を使用して、例3-4に示すJavaコードをコンパイルします。
コンパイル後、オペレーティング・システムのコマンドラインで次のようにしてプログラムを実行します。
java XDKVersion
結果は次のようになります。
You are using version: Oracle XML Developers Kit 11.1.0.6.0 - Production
例3-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()); } }