この章の内容は次のとおりです。
Java XDKコンポーネントは、Oracle Databaseに付属しています。この章では、Oracle DatabaseとともにXDKをインストールし、Oracle Database Examplesメディアのデモ・プログラムもインストールしたと想定します。インストールの手順およびXDKディレクトリ構造の説明は、「XDKのインストール」を参照してください。
例3-1に、XDKデモとXDKコンポーネントで使用されるライブラリのUNIXディレクトリ構造を示します。$ORACLE_HOME/xdk/demo/java
のサブディレクトリには、XDK for Javaコンポーネントのサンプル・プログラムとデータ・ファイルが入っています。第I部「XDK for Java」では、これらのプログラムを理解および使用する方法について説明します。
例3-1 Java XDKのライブラリ、ユーティリティおよびデモ
- Oracle_home_directory | - bin/ orajaxb orapipe oraxml oraxsl transx | - lib/ classgen.jar jdev-rt.zip oraclexsql.jar transx.zip xml.jar xml2.jar xmlcomp.jar xmlcomp2.jar xmldemo.jar xmlmesg.jar xmlparserv2.jar xschema.jar xsqlserializers.jar xsu12.jar | - jlib/ orai18n.jar orai18n-collation.jar orai18n-mapping.jar orai18n-utility.jar | - jdbc/ | - lib/ ojdbc5.jar | - rdbms/ | - jlib/ xdb.jar
| - xdk/ | demo/ | - java/ | - classgen/ | - jaxb/ | - parser/ | - pipeline/ | - schema/ | - transviewer/ | - tranxs/ | - xsql/ | - xsu/
サブディレクトリには、Java XDKコンポーネントのサンプル・プログラムとデータ・ファイルが入っています。第I部「XDK for Java」では、これらのプログラムを使用して最も重要なJava言語の機能を理解する方法について説明します。
Java XDKコンポーネントは、JDKバージョン5および6でサポートされ、動作が保証されています。それより前のJavaはサポートが終了しました。図3-1に、JDK 5を使用する場合のJava XDKコンポーネントの依存性を示します。
Java XDKコンポーネントには、表3-1にアルファベット順に示されているライブラリが必要です。一部のライブラリはXDKに固有ではなく、他のOracle Databaseコンポーネント間で共有されます。
表3-1 XDKコンポーネントのJavaライブラリ
ライブラリ | ディレクトリ | 内容 |
---|---|---|
|
|
Java Runtimeクラス用のXML Class Generator。 注意: このライブラリは、下位互換性のみを目的として保持されています。 |
|
|
JDeveloper IDEでデモを操作する際に使用するJava GUIライブラリ。 |
|
|
Java 5、6用のOracle JDBCドライバ。UTF-8、ISO8859-1またはJA16SJIS以外のマルチバイト・キャラクタ・セットを使用する場合、このJARはキャラクタ・セットをサポートするための |
|
|
XSQLページの作成に必要なXSQLサーブレット・クラスの大部分。 注意: このアーカイブは |
|
|
JDK 1.2以上に対するグローバリゼーション・サポート。これは、他のすべてのグローバリゼーションjarのラッパーであり、キャラクタ・セット・コンバータを含みます。UTF-8、ISO8859-1またはJA16SJIS以外のマルチバイト・キャラクタ・セットを使用する場合は、XSU、TransX Utility、XSQLサーブレットのいずれかを使用したXMLファイルのロード中にJDBCが入力ファイルのキャラクタ・セットをデータベース・キャラクタ・セットに変換できるように、このアーカイブを |
|
|
グローバリゼーション照合機能: |
|
|
グローバリゼーション・ロケールとキャラクタ・セット名のマッピング: |
|
|
グローバリゼーション・ロケール・オブジェクト: |
|
|
TransX Utilityクラス。 注意: このアーカイブは |
|
|
|
|
|
次のライブラリ内のクラス。
アーカイブには、JAXBおよびPipeline Processorのクラスも含まれています。 |
|
|
データベースに依存しないXML JavaBeans: 注意: このアーカイブは下位互換性のみを目的として含められています。このアーカイブ内のクラスは |
|
|
データベースに依存するXML JavaBeans: 注意: このJARは下位互換性のみを目的として含められています。このJAR内のクラスは |
|
|
ビジュアルなJavaBeans: |
|
|
XMLパーサーを英語以外の言語で使用する場合に必要です。 |
|
|
次のものに対するAPI。
このライブラリには |
|
|
注意: このJARファイルは、下位互換性のみを目的として保持されています。 |
|
|
PDFなどのシリアライズされた出力に必要な、XSQLサーブレットのシリアライザ・クラス。 注意: このアーカイブは |
|
|
XSUを実装するクラス。これらのクラスは、 |
関連項目:
|
XDKのOracle Databaseインストールでは、環境変数$CLASSPATH
(UNIX)または%CLASSPATH%
(Windows)を手動で設定する必要があります。または、コマンドラインでJavaプログラムをコンパイルおよび実行する際に-classpath
オプションを設定します。
この項の内容は次のとおりです。
表3-2に、Java XDKコンポーネントを使用するときに必要なUNIX環境変数を示します。
表3-2 Java XDKコンポーネントのUNIXでの環境設定
変数 | 説明 |
---|---|
|
次の内容を含めます(現在のディレクトリを表すシングル・ピリオド"."は必須ではありませんが、役に立つ場合があります)。
|
|
JDK 5の場合は、次のように設定します。
特定のキャラクタ・セットをサポートするには、 |
|
Java JDK, Standard Editionのインストール・ディレクトリ。Java SDKにリンクするパスを変更します。 |
|
OCI/JDBC接続用:
|
|
|
表3-3に、Java XDKに含まれているコマンドライン・ユーティリティ(UNIX)を示します。これらのユーティリティを使用する前に、環境を設定する必要があります。
表3-3 Java XDKユーティリティ
実行可能ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このスクリプトは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
環境が正しく設定されている場合は、例3-2に示すUNIXシェル・スクリプトによって、ユーティリティのバージョンと使用方法に関する情報が生成されます。
例3-2 UNIXでのJava XDK環境のテスト
#!/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に、Java XDKコンポーネントを使用するときに必要なWindows環境変数を示します。
表3-4 Java XDKコンポーネントのWindowsでの環境設定
変数 | 注意 |
---|---|
|
次の内容を含めます(現在のディレクトリを表すシングル・ピリオド"."は必須ではありませんが、役に立つ場合があります)。
|
|
JDK 5の場合は、次のように設定します。
特定のキャラクタ・セットをサポートするには、 |
|
Java SDK, Standard Editionのインストール・ディレクトリ。Java SDKにリンクするパスを変更します。 |
|
|
表3-5に、Java XDKに含まれているコマンドライン・ユーティリティ(Windows)を示します。これらのユーティリティを使用する前に、環境を設定する必要があります。
表3-5 Java XDKユーティリティ
バッチ・ファイル/クラス | ディレクトリ/JAR | 説明 |
---|---|---|
|
|
XSQLコマンドライン・ユーティリティ。このバッチ・ファイルは、 |
|
|
XSUコマンドライン・ユーティリティ |
|
|
JAXBコマンドライン・ユーティリティ |
|
|
Pipelineコマンドライン・ユーティリティ |
|
|
XML Parserコマンドライン・ユーティリティ |
|
|
XSLT Processorコマンドライン・ユーティリティ |
|
|
TransXコマンドライン・ユーティリティ |
環境が正しく設定されている場合は、例3-3のコマンドをシステム・プロンプトで実行して、ユーティリティのバージョンと使用方法に関する情報を生成できます。
使用しているXDKのバージョンを取得するには、javac
を使用して、例3-4に示すJavaコードをコンパイルします。
例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()); } }
javac
を使用してソース・ファイルをコンパイルした後、オペレーティング・システムのコマンドラインで次のようにプログラムを実行します。
java XDKVersion You are using version: Oracle XML Developers Kit 11.1.0.6.0 - Production