| Oracle® XML Developer's Kitプログラマーズ・ガイド 12c リリース1 (12.1) B71283-04 |
|
 前 |
 次 |
この章では、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());
}
}
