BEA ホーム | 製品 | dev2dev | support | askBEA
 ドキュメントのダウンロード   サイト マップ   Glossary 
検索
e-docs > WebLogic Server > WebLogic J2EE コネクタ アーキテクチャ > リソース アダプタのパッケージ化とデプロイメント

WebLogic J2EE コネクタ アーキテクチャ

 Previous Next Contents Index PDF で侮ｦ  

リソース アダプタのパッケージ化とデプロイメント

この章では、リソース アダプタのパッケージ化とデプロイメント要件について説明し、これらのタスクを実行する方法を説明します。

 

リソース アダプタのパッケージ化

パッケージ化されたリソース アダプタ モジュールのファイル形式は、リソース アダプタ プロバイダとデプロイヤとの間の規約を定義します。パッケージ化されたリソース アダプタには以下の要素が含まれます。

この節では、リソース アダプタのパッケージ化に関するガイドライン、要件、および制限について説明し、リソース アダプタをパッケージ化する方法を説明します。

ディレクトリ構造のパッケージ化

リソース アダプタは、applications/ ディレクトリ内のリソース アダプタ アーカイブ (RAR) に含まれる WebLogic Server コンポーネントです。デプロイメント プロセスは、リソース アダプタ プロバイダによって作成されたコンパイル済みリソース アダプタ インタフェースと実装クラスを格納する、RAR またはデプロイメント ディレクトリで開始されます。RAR とデプロイメント ディレクトリは、どちらがコンパイル済みクラスを格納している場合でも、Java パッケージ構造と一致するサブディレクトリに入っている必要があります。

リソース アダプタは、共通のディレクトリ形式を使用します。この形式は、リソース アダプタを RAR として展開ディレクトリ形式でパッケージ化するときにも使用されます。リソース アダプタの構造の例を示します。

コード リスト 7-1 リソース アダプタのディレクトリ構造

/META-INF/ra.xml
/META-INF/weblogic-ra.xml
/META-INF/MANIFEST.MF (省略可能)
/images/ra.jpg
/readme.html
/eis.jar
/utilities.jar
/windows.dll
/unix.so

パッケージ化の考慮事項

リソース アダプタのパッケージ化には次の要件があります。

パッケージ化の要件に関する詳細については、「J2EE コネクタ仕様、バージョン 1.0、最終リリース」(http://java.sun.com/j2ee/download.html#connectorspec) を参照してください。

パッケージ化の制限

WebLogic Server でのリソース アダプタに対するパッケージ化の制限は以下のとおりです。

リソース アダプタ アーカイブ (RAR) のパッケージ化

1 つまたは複数のリソース アダプタを、1 つのディレクトリにステージングした後で Java アーカイブ (JAR) にパッケージ化できます。リソース アダプタをパッケージ化する前に、WebLogic Server がクラスをロードする方法を説明する『WebLogic Server アプリケーションの開発』の「WebLogic Server J2EE アプリケーション クラスローディング」を読み、理解してください。

リソース アダプタをステージングおよびパッケージ化するには、次の手順に従います。

  1. 一時ステージング ディレクトリをハードディスクの任意の場所に作成します。

  2. 対象となるリソース アダプタの Java クラスをステージング ディレクトリにコンパイルまたはコピーします。

  3. リソース アダプタの Java クラスを入れる JAR を作成します。この JAR をステージング ディレクトリの最上位に追加します。

  4. ステージング ディレクトリに META-INF サブディレクトリを作成します。

  5. META-INF サブディレクトリに ra.xml デプロイメント記述子を作成して、そのリソース アダプタのエントリを追加します。

    注意: ra.xml の文書型定義の詳細については、以下の Sun Microsystems のドキュメントを参照してください。
    http://java.sun.com/dtd/connector_1_0.dtd

  6. META-INF サブディレクトリに weblogic-ra.xml デプロイメント記述子を作成して、そのリソース アダプタのエントリを追加します。

    注意: weblogic-ra.xml 文書型定義の詳細については、weblogic-ra.xml デプロイメント記述子の要素を参照してください。

  7. リソース アダプタ クラスとデプロイメント記述子をステージング ディレクトリに配置すると、次のような JAR コマンドを使用して RAR を作成できます。 
    jar cvf jar-file.rar -C staging-dir

    このコマンドによって作成された RAR は、WebLogic Server にデプロイすることも、またはアプリケーション アーカイブ (EAR) にパッケージ化することもできます。

    -C staging-dir オプションを指定すると、JAR コマンドはディレクトリを staging-dir に変更します。これにより、JAR に記録されるディレクトリ パスがリソース アダプタのステージング ディレクトリを基準にした相対パスとなります。

このトピックの詳細については、リソース アダプタの作成と変更 : 主な手順を参照してください。

 

リソース アダプタのデプロイ

リソース アダプタのデプロイメントは、Web アプリケーション、EJB、およびエンタープライズ アプリケーションのデプロイメントとほぼ同じです。これらのデプロイメント ユニットと同様、リソース アダプタも展開ディレクトリ形式でデプロイしたり、アーカイブ ファイルとしてデプロイしたりすることができます。

デプロイメント オプション

リソース アダプタは以下の方法でデプロイできます。

デプロイメント記述子

Web アプリケーション、EJB、およびエンタープライズ アプリケーションと同様、リソース アダプタは 2 つのデプロイメント記述子を使用して操作パラメータを定義します。デプロイメント記述子 ra.xml は、Sun Microsystems の「J2EE コネクタ仕様、バージョン 1.0、最終リリース」で定義されています。weblogic-ra.xml デプロイメント記述子は、WebLogic Server に固有のもので、WebLogic Server に対してのみ有効な操作パラメータを定義します。weblogic-ra.xml デプロイメント記述子の詳細については、weblogic-ra.xml デプロイメント記述子の要素.を参照してください。

リソース アダプタのデプロイメント名

リソース アダプタのアーカイブ (RAR) またはデプロイメント ディレクトリをデプロイする場合は、myResourceAdapter のように、デプロイメント ユニットの名前を指定する必要があります。この名前を使用すると、後でリソース アダプタをアンデプロイしたり更新したりする場合に、リソース アダプタのデプロイメントを簡単に参照できます。

リソース アダプタをデプロイする場合は、WebLogic Server が、RAR またはデプロイメント ディレクトリのパスおよびファイル名と一致するデプロイメント名を暗黙的に割り当てます。この名前を使用すると、サーバが起動した後にリソース アダプタをアンデプロイまたは更新できます。

リソース アダプタのデプロイメント名は、サーバが再起動されるまで、WebLogic Server 内でアクティブなままです。リソース アダプタをアンデプロイしても、関連付けられたデプロイメント名は削除されません。リソース アダプタを再デプロイするために後でその名前を使う場合があるからです。

weblogic.Deployer ユーティリティの使用

weblogic.Deployer ユーティリティは WebLogic Server 7.0 の新機能で、非推奨となった weblogic.deploy ユーティリティに代わるものです。この節では、weblogic.Deployer ユーティリティを使って以下のタスクを実行する方法について説明します。

weblogic.Deployer ユーティリティを使ってコネクタをデプロイする方法の詳細については、『WebLogic Server アプリケーションの開発』の「WebLogic Server デプロイメント」を参照してください。

Administration Console の使い方

この節では、Administration Console を使用したリソース アダプタのデプロイメント作業について説明します。Administration Console を使用すると、以下のタスクを実行できます。

WebLogic Server Administration Console を使ってコネクタをデプロイする方法の詳細については、『WebLogic Server アプリケーションの開発』の「WebLogic Server デプロイメント」を参照してください。

エンタープライズ アプリケーション アーカイブ (EAR) へのリソース アダプタの追加

J2EE プラットフォーム仕様、バージョン 1.3、最終リリースの仕様として、リソース アダプタ アーカイブ (RAR) をエンタープライズ アプリケーション アーカイブ (EAR) の内部に追加し、その上でアプリケーションを WebLogic Server にデプロイすることができます。

リソース アダプタ アーカイブを含むエンタープライズ アプリケーションをデプロイするには次の手順に従います。

  1. Web アプリケーション アーカイブ (WAR) または JAR の場合と同じように RAR を EAR の内部に置きます。

  2. 有効な application.xml を作成し、EAR の META-INF ディレクトリに格納します。

    application.xml を作成する際には以下の点に注意してください。

    アプリケーション デプロイメント記述子には、EAR 内のリソース アダプタ アーカイブを識別するための新しい <connector> 要素を含める必要があります。たとえば、次のように送出されます。

	<connector>RevisedBlackBoxNoTx.rar</connector>

<connector> は J2EE プラットフォーム仕様、バージョン 1.3 で新たに追加された要素なので、application.xml ファイルには、J2EE プラットフォーム仕様、バージョン 1.3 のデプロイメント記述子として識別するために次の DOCTYPE エントリを含める必要があります。

コード リスト 7-2 DOCTYPE エントリ

<!DOCTYPE application PUBLIC '-//Sun Microsystems, Inc.//DTD
J2EE Application 1.3//EN'
	‘http://java.sun.com/dtd/application_1_3.dtd’>

DOCTYPE エントリを含めなかった場合、リソース アダプタはデプロイされません。

application.xml ファイルの例を以下に示します。

コード リスト 7-3 application.xml ファイル

<application>
	<display-name> ConnectorSampleearApp </display-name>
	<module>
		<connector>RevisedBlackBoxNoTx.rar</connector>
	</module>
	<module>
		<ejb>ejb_basic_beanManaged.jar</ejb>
	</module>
</application>

  1. エンタープライズ アプリケーションを WebLogic Server にデプロイします。

    エンタープライズ アプリケーションのデプロイ作業の概要については、「WebLogic Server J2EE アプリケーションについて」の「エンタープライズ アプリケーション」を参照してください。

 

Back to Top Previous Next