ADF ToyStore
- 6: アプリケーションの配置とパッケージングに関する考慮事項 -

サンプル・アプリケーションにおけるJDeveloperのデプロイメント・プロファイル

図62: ADFToyStore.deployプロファイルの設定

ToyStoreModelプロジェクトには、 ToyStoreModel.bcdeployというADFビジネス・コンポーネント用デプロイメント・プロファイルが含まれています。 これは、アプリケーション・ナビゲータで ToyStoreServiceアプリケーション・モジュールを選択し、マウスを右クリックして 「ビジネス・コンポーネントのデプロイメント...」を選択することによって作成されました。 表示されるウィザードでは 「シンプル・アーカイブ・ファイル」オプションを選択しました。 ナビゲータのノードを展開すると、デプロイメント・プロファイルに、次のような2つの子プロファイルが含まれていることがわかります。これらの子プロファイルには、コンパイル済みのファイル構造のパッケージング定義が次のように設定されています 。

• カスタム・コンポーネント・インタフェースとメッセージ・ファイルのパッケージング。これらは、プロジェクトの *.commonサブパッケージから ToyStoreModelCSCommon.jarファイルへパッケージングされます。
• コンポーネントの実装ファイル（*Impl.java）とXMLの定義ファイルのパッケージング。これらのファイルは ToyStoreModelCSMT.jarファイルへパッケージングされます。

このサンプル・アプリケーションのように、StrutsのWebコントローラ層が、Webコンテナ内にシンプルなJavaBeansとしてADFのモデル層を使用しているケースでは、これらの2つのJARファイルは、両方ともWebコンテナのクラスパスに配置する必要があります。 リモートの中間層にアクセスするSwingアプリケーション、またはEJB Session Beanとしてデプロイされているアプリケーション・モジュールにアクセスするWeb層では、クライアント層では ToyStoreModelCSCommon.jarのみが必要です。 このようなシナリオでは、 ToyStoreModelCSMT.jarは、EJB Session Beanのクラス・パスに含める必要があります。

外部のアプリケーション・サーバーにサンプル・アプリケーションをデプロイする

ADFToyStore.deployデプロイメント・プロファイルを使用すると、最初に次の2つの事前手順を実行した後は、デプロイ/再デプロイを1つの手順で実行できます。

1. ターゲットのアプリケーション・サーバーに対して、アプリケーション・サーバーの接続を定義する
   これを実行するには、JDeveloperの 「接続ナビゲータ」で、 「アプリケーション・サーバー」フォルダをマウスで右クリックし、 「新規...」を選択します。
2. ADF Runtime Installerを実行して、ターゲット・サーバーにOracle ADFフレームワークをインストールする

この項では、アプリケーションをデプロイするための基本事項について取り上げます。

ADF Runtime Installerの実行

JDeveloper 10gを使用して作成したADFアプリケーションを、次のいずれかのサーバーにデプロイする場合は、自動のフレームワーク・インストール機能が提供されます。

• スタンドアロンOC4J
• Oracle Application Server
• Apache Tomcat
• JBoss
• BEA WebLogic

これらのいずれかのサーバーにADFフレームワークをインストールするには、 「ツール→ADF Runtime Installer→<YourServerType>」を選択します。 ウィザードで、サーバーをインストールするためのルート・ディレクトリを指定するよう要求されます。 ルート・ディレクトリを指定すると、ユーザーが次の手順の処理を確認した後で、サーバーが構成されます。 ウィザードでは、ファイル・コピー、および構成ファイルに対して行なわれた修正のすべてを詳細に記述するログ・ファイルを生成します（発生したすべてのエラーについてもレポートされます）。また、参照できるように、エディタ・ウィンドウにログ・ファイルをオープンします。

デプロイの実行

ADF ToyStoreサンプル・アプリケーションを、事前に定義されているアプリケーション・サーバー接続にデプロイするには、アプリケーション・ナビゲータで ADFToyStore.deployノードをクリックし、マウスを右クリックしてメニューで 「配布先→<YourServerName>」を選択します。

Antを使用したサンプル・アプリケーションの構築、パッケージ、およびデプロイ

JDeveloper内でのAntターゲットの実行

図63: ADFToyStoreワークスペースのデプロイメント・プロファイルとビルドファイル

ADFToyStore.earファイルを構築するには、 earビルド・ターゲットを選択します。
ADFToyStore.warファイルを構築するには、 warビルド・ターゲットを選択します。

JDeveloperからAntを使用している場合は、 jdev.homeパラメータに、JDeveloperのホーム・ディレクトリが設定されます。 このようにして、Antのビルド・スクリプトからJDeveloperのインストレーション・ホームに関連するファイルへの参照を作成できます。 ADF ToyStoreの build.xmlファイルは、この処理を行います。 したがって、JDeveloperの外部のコマンドラインから、次のようなビルド・ターゲットを実行しようとすると

$ ant ear

次のような警告メッセージが表示されます。

Buildfile: build.xml
init:
BUILD FAILED
C:\adftoystore\build.xml:52: Need to set jdev.home property to JDev home dir!

したがって、このように処理するかわりに、 antコマンドラインでjdev.homeの値を渡して構築する必要があります。

$ ant -Djdev.home=C:\Oracle\jdev905 ear

ここで、 C:\Oracle\jdev905はJDeveloperのインストレーション・ホーム・ディレクトリで置き換える場所の例です。

Antのビルドファイルを使用したデプロイ

このビルドファイルには、 deployと deploycleanというAntビルド・ターゲットを設定しました。これらのターゲットは、ビルド・スクリプトからスタンドアロンOC4Jのインストールを実行します。 ユーザーは、Antからのデプロイ処理を実現するために、build.xmlの次のようなセクションでプロパティを編集し、自身の環境にとって適切な値を指定する場合があります。

  <!--
   | Local OC4J Connection Information for "deploy" task
   +-->
  <property name="oc4j.admin.jar" value="${jdev.home}/j2ee/home/admin.jar"/>
  <property name="oc4j.url" value="ormi://localhost/"/>
  <property name="oc4j.username" value="admin"/>
  <property name="oc4j.password" value="welcome"/>
  <property name="j2ee.app.name" value="ADFToyStore"/>
  <property name="j2ee.web.app.name" value="ADFToyStore"/>
  <property name="oc4j.web.site" value="http-web-site"/>
  <property name="j2ee.context.root" value="/ADFToyStore"/>

これらのパラメータは、コマンドラインのデプロイ用ユーティリティ admin.jarへ渡される引数として、 deploy タスクで使用されます。

• 本書はOracle Corporation発行の「Building a Web Store with Struts & ADF Frameworks」を翻訳し、再構成したものです。
• この文書はあくまでも参考資料であり、掲載されている情報は予告なしに変更されることがあります。 万一、誤植などにお気づきの場合は、オラクル社までお知らせください。オラクル社は本書の内容に関していかなる保証もしません。また、本書の内容に関連したいかなる損害についても責任を負いかねます。