10g（10.1.3.1.0）
B31868-01
 目次 |
 索引 |
| Oracle Application Server Web Services開発者ガイド 10g（10.1.3.1.0） B31868-01 |
|
OC4Jの設定および実行方法は、OC4Jディストリビューションの最上位レベルにあるREADME.txtファイルを参照してください。この章は、このREADMEファイルの追補です。この章では、ユーザー環境におけるOracle Application Server Web Servicesの設定の詳細情報について説明します。
この章の内容は、次のとおりです。
OracleAS Web Servicesは、次のプラットフォームでサポートされています。
OC4Jのインストールおよび実行方法については、README.txtファイルの指示に従ってください。README.txtファイルは、OC4Jディストリビューションの最上位レベルにあります。
この項では、OracleAS Web Servicesを使用するためにインストールする必要があるソフトウェアと定義する必要がある環境変数について説明します。
http://jakarta.apache.org/ant/index.html
ORACLE_HOME/webservices/lib/wsa.jar）へのパスとXMLパーサーのJARへのパス（ORACLE_HOME/lib/xmlparserv2.jar）をクラスパスに追加します。
CLASSPATH設定については、Webサービスのコード例に付随するAntスクリプトを参照してください。コマンドラインでWebServicesAssemblerを起動し、生成されたコードをコンパイルする場合、完全なライブラリをCLASSPATHに追加できます。すべてのOracleAS Web ServicesクライアントJARファイルに対するWindowsプラットフォームのset CLASSPATHコマンドのサンプルは、「CLASSPATHコマンドのサンプル」を参照してください。UNIXプラットフォームのクラスパスも同じ方法で設定されます。
wsclient_extended.jarが用意されています。このライブラリには、J2SE環境でOracleAS Web Servicesクライアントに必要となるすべてが含まれています。このライブラリにより、J2SEクライアント・アプリケーションのパッケージ化と配布が簡単になります。wsclient_extended.jarファイルは、Oracle Technology NetworkのWebサイトの次のアドレスにあります。http://download.oracle.com/otn/java/oc4j/10131/wsclient_extended.zip
OC4J Companion CDをインストールした場合、wsclient_extended.jarファイルはORACLE_HOME/webservices/libディレクトリにも置かれます。
wsclient_extended.jarファイルの詳細は、「wsclient_extended.jarによるクラスパスの単純化」を参照してください。
SQLスクリプトの検索および実行方法については、『Oracle Application Server Web Servicesアドバンスト開発者ガイド』のクライアントおよびサーバーに対するSQL表のインストールに関する項を参照してください。
このトピックの詳細は、「データベース要件」を参照してください。
WebServicesAssemblerツールを使用すると、OracleAS Web Servicesをアセンブルできます。WebServicesAssemblerツールを使用すると、トップダウン方式とボトムアップ方式のどちらを使用してWebサービスを作成するかにかかわらず、サービスの開発およびデプロイに必要なアーチファクトを生成できます。WebServicesAssemblerのコマンドは、コマンドラインとAntタスクのどちらからもコールできます。
この項では、WebServicesAssemblerコマンドをAntタスクからコールできるように環境を設定し、スクリプト・ファイルをビルドする方法について説明します。以前にインストールしたAntインストールを使用するか、またはORACLE_HOME/antにあるAntを使用することができます。次の各項では、Antを、インストールしたバージョンに応じて設定する方法について説明します。
次の手順では、ORACLE_HOME/antにあるAnt 1.6.5インストールとともにWebServicesAssemblerを使用できるように環境およびビルド・ファイルを設定する方法について説明します。このAntのバージョンは、Oracle Application Serverに付属しているものです。
PATH変数の前にORACLE_HOME/ant/binを入力します。
build.xml）を編集します。インポートされるAntタスクにantlib:oracle名前空間宣言を追加します。次の例では、bottomupがプロジェクトの名前です。
<project name="bottomup" default="all" basedir="." xmlns:oracle="antlib:oracle">
oracle:名前空間を接頭辞としてWebServicesAssemblerのすべてのタグに追加します。次に例を示します。
<oracle:assemble ....> <oracle:port ... /> </oracle:assemble> <oracle:genProxy ..../>
ant-oracle.propertiesファイルをビルド・スクリプトと同じディレクトリにコピーします。j2ee/utilitiesディレクトリにあるこのプロパティ・ファイルを変更し、ビルド・スクリプトから参照することもできますが、このファイルはテンプレートとして保持しておくことをお薦めします。
ant-oracle.propertiesファイルを編集します。
build.xml）を編集します。ビルド・スクリプトでant-oracle.propertiesファイルを参照します。次に例を示します。
<property file="ant-oracle.properties"/>
junit Antタスクを使用する場合、ANT_OPTSシステム・プロパティをXalan TransformerFactoryImplクラスに設定します。
TransformerFactoryのANT_OPTSプロパティをcom.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
TransformerFactoryのANT_OPTSプロパティをorg.apache.xalan.processor.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl
次の手順では、Ant 1.6.5（以上）より前のインストールとともにWebServicesAssemblerを使用できるように環境およびビルド・ファイルを設定する方法について説明します。
ORACLE_HOME/j2ee/utilitiesにナビゲートし、次のファイルが存在することを確認します。
ant-oracle.propertiesおよびant-oracle.xmlファイルをビルド・スクリプト（build.xml）と同じディレクトリにコピーします。j2ee/utilitiesディレクトリにあるファイルを変更し、ビルド・スクリプトから参照することもできますが、ソース・ファイルはテンプレートとして保持しておくことをお薦めします。また、ant-oracle.xmlファイルを元の場所に残しておく場合、インポート参照をハードコード化し、ファイルのフルパス（c:/oc4j/j2ee/utilities/ant-oracle.xmlなど）を指定する必要があります。
ant-oracle.propertiesファイルを編集します。
build.xml）を編集します。
oracle:名前空間を接頭辞としてWebServicesAssemblerのすべてのコマンドに含めます。次に例を示します。
<oracle:deploy ..../> <oracle:genProxy ..../>
junit Antタスクを使用する場合、ANT_OPTSシステム・プロパティをXalan TransformerFactoryImplクラスに設定します。
TransformerFactoryのANT_OPTSプロパティをcom.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
TransformerFactoryのANT_OPTSプロパティをorg.apache.xalan.processor.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl
次の手順では、Ant 1.5.2より前のインストールとともにWebServicesAssemblerを使用できるように環境およびビルド・ファイルを設定する方法について説明します。
wsa.jarのパスをCLASSPATH環境変数に追加します。通常、このパスは次のとおりです。
OC4J_Home/webservices/lib/wsa.jar
この例では、OC4J_Homeは、OC4Jをインストールしたディレクトリです。
<taskdef resource="orawsa.tasks" /> <typedef resource="orawsa.types" />
これらの行は、ビルド・ファイル内において、最初のWebServicesAssemblerタスクがコールされるより前の場所なら、任意の場所に指定できます。
junit Antタスクを使用する場合、ANT_OPTSシステム・プロパティをXalan TransformerFactoryImplクラスに設定します。
TransformerFactoryのANT_OPTSプロパティをcom.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl
TransformerFactoryのANT_OPTSプロパティをorg.apache.xalan.processor.TransformerFactoryImplに設定します。次に例を示します。
set ANT_OPTS=-Djavax.xml.transform.TransformerFactory=org.apache.xalan.processor.TransformerFactoryImpl
Antバージョン1.6.5以上では、WebServicesAssemblerコマンドのすべてのAntタグおよびサブタグの先頭にoracle:接頭辞が必要です。この接頭辞により、これがOracle AntタスクであることをAntインタプリタに通知します。
oracle:接頭辞は、Antのbuild.xmlファイルの先頭のprojectタグにある接頭辞に対応しています。
<project name="myproject" default="all" basedir="." xmlns:oracle="antlib:oracle">
oracleを接頭辞として使用しない場合は、XMLの有効な任意のQName接頭辞に変更できます。たとえば、oracletagsを接頭辞として使用する場合は、projectタグの値を変更する必要があります。
<project name="myproject" default="all" basedir="." xmlns:oracletags="antlib:oracle">
この変更を行う場合、WebServicesAssemblerコマンドのすべてのAntタグおよびサブタグはoracletags:で始まる必要があります。次に例を示します。
<oracletags:assemble ...>
次のいずれかのタスクを実行する場合、Oracleデータベース（ローカルまたはリモート）をインストールして稼働しておく必要があります。
|
 Copyright © 2006 Oracle Corporation. All Rights Reserved. |
|