BEA ホーム | 製品 | dev2dev | support | askBEA
 ドキュメントのダウンロード   サイト マップ   Glossary 
検索
e-docs > WebLogic Server > WebLogic J2EE コネクタ アーキテクチャ > コンフィグレーション

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

 Previous Next Contents Index PDF で侮ｦ  

コンフィグレーション

以下の節では、WebLogic J2EE コネクタ アーキテクチャ実装のコンフィグレーション要件について説明します。

 

リソース アダプタの開発者向けツール

BEA では、リソース アダプタの作成とコンフィグレーションを支援するツールを提供しています。この節では、これらのツールについて説明します。

スケルトン デプロイメント記述子を作成する ANT タスク

スケルトン デプロイメント記述子を作成するときに、WebLogic ANT ユーティリティを利用できます。ANT ユーティリティは WebLogic Server 配布キットと共に出荷されている Java クラスです。ANT タスクによって、リソース アダプタを含むディレクトリが調べられ、そのリソース アダプタで検出されたファイルを基にデプロイメント記述子が作成されます。ANT ユーティリティは、個別のリソース アダプタに必要なコンフィグレーションやマッピングに関する情報をすべて備えているわけではないので、ANT ユーティリティによって作成されるスケルトン デプロイメント記述子は不完全なものです。ANT ユーティリティがスケルトン デプロイメント記述子を作成した後で、テキスト エディタ、XML エディタ、または Administration Console を使ってデプロイメント記述子を編集し、リソース アダプタのコンフィグレーションを完全なものにしてください。

ANT ユーティリティを使用してデプロイメント記述子を作成する方法の詳細については、「リソース アダプタのパッケージ化」を参照してください。

リソース アダプタのデプロイメント記述子エディタ

WebLogic Server の Administration Console には、統合されたデプロイメント記述子エディタがあります。この統合エディタを使用する前に、少なくともスケルトン ra.xml デプロイメント記述子を作成しておく必要があります。詳細については、weblogic-ra.xml デプロイメント記述子の要素.を参照してください。

XML エディタ

BEA では、XML ファイルの作成と編集のために簡単で使いやすい Ensemble のツールを用意しました。このツールを使うと、指定した DTD または XML スキーマに従って XML コードの有効性を検証できます。この XML エディタは、Windows または Solaris のマシンで使用でき、BEA dev2dev Online からダウンロードできます。

 

リソース アダプタのコンフィグレーション

この節では、WebLogic Server にデプロイするためのリソース アダプタをコンフィグレーションする方法について説明します。

リソース アダプタの概要

WebLogic J2EE コネクタ アーキテクチャを使用すると、エンタープライズ情報システム (EIS) ベンダとサードパーティ アプリケーション開発者は、Sun Microsystems の J2EE プラットフォーム仕様、バージョン 1.3 に準拠しているアプリケーション サーバにデプロイ可能なリソース アダプタを開発できます。

リソース アダプタは WebLogic J2EE コネクタ アーキテクチャの中核をなすもので、クライアント コンポーネントと EIS との間の J2EE コネクタとして機能します。リソース アダプタを WebLogic Server 環境にデプロイすると、リモート EIS システムにアクセスする堅牢な J2EE プラットフォーム アプリケーションを開発できるようになります。リソース アダプタには、Java コンポーネントに加えて、必要な場合には EIS との対話に必要なネイティブ コンポーネントが入っています。

リソース アダプタの作成については、Sun Microsystems の J2EE コネクタ アーキテクチャのページと「J2EE コネクタ仕様、バージョン 1.0、最終リリース」を参照してください。これらの参照先は Sun Microsystems の Web サイトで公開されており、それぞれの URL は以下のとおりです。

http://java.sun.com/j2ee/connector/

http://java.sun.com/j2ee/download.html#connectorspec

リソース アダプタの作成と変更 : 主な手順

リソース アダプタを作成するには、個々のリソース アダプタ用のクラス (ConnectionFactory や Connection など) とコネクタ固有のデプロイメント記述子を作成してから、それらを WebLogic Server にデプロイする jar ファイルにすべてパッケージ化する必要があります。

新規リソース アダプタ アーカイブ (RAR) の作成

リソース アダプタ アーカイブ (RAR) を作成する主な手順を以下に説明します。

  1. 「J2EE コネクタ仕様、バージョン 1.0、最終リリース」(http://java.sun.com/j2ee/download.html#connectorspec) に準拠して、リソース アダプタ (ConnectionFactory など) に必要な各種クラスの Java コードを記述します。

    リソース アダプタを実装するときは、以下のように ra.xml ファイルでクラスを指定しなければなりません。たとえば、次のように指定します。

  2. インタフェースと実装の Java コードをクラス ファイルにコンパイルします。

    コンパイルの詳細については、『WebLogic Server アプリケーションの開発』の「Preparing to Compile」を参照してください。

  3. Java クラスを Java アーカイブ (JAR) にパッケージ化します。パッケージ化の詳細については、リソース アダプタのパッケージ化とデプロイメントを参照してください。

  4. リソース アダプタ固有のデプロイメント記述子を作成します。

    詳細については、ra.xml ファイルのコンフィグレーションおよびweblogic-ra.xml ファイルのコンフィグレーションを参照してください。

    注意: リソース アダプタ RAR に weblogic-ra.xml ファイルが含まれない場合、WebLogic Server はこのファイルを自動的に作成します。詳細については、ra.xml ファイルのコンフィグレーション.を参照してください。

  5. リソース アダプタ アーカイブ (RAR) を作成します。

    1. 最初に、空のステージング ディレクトリを作成します。

    2. リソース アダプタの Java クラスが入った RAR をステージング ディレクトリに格納します。

    3. デプロイメント記述子を META-INF というサブディレクトリに格納します。

    4. 次に、ステージング ディレクトリで次のように jar コマンドを実行して、リソース アダプタのアーカイブを作成します。

      jar cvf myRAR.rar *

      リソース アダプタのアーカイブ ファイルの作成については、リソース アダプタ アーカイブ (RAR) のパッケージ化を参照してください。

  6. RAR を WebLogic Server にデプロイするか、エンタープライズ アプリケーションの一部としてデプロイするエンタープライズ アプリケーション (EAR) で RAR を使用します。

    リソース アダプタのデプロイ プロセスの詳細については、リソース アダプタのパッケージ化とデプロイメントを参照してください。

既存のリソース アダプタ アーカイブ (RAR) の変更

以下は、既存のリソース アダプタ アーカイブを WebLogic Server にデプロイするために変更する方法の例です。この場合、デプロイメント記述子 weblogic-ra.xml を追加し、再パッケージ化する必要があります。

  1. リソース アダプタをステージングするための一時ディレクトリを作成します。
	mkdir c:/stagedir

  1. 一時ディレクトリにデプロイするリソース アダプタをコピーします。
	cp blackbox-notx.rar c:/stagedir

  1. リソース アダプタ アーカイブの中身を展開します。
	cd c:/stagedir
	jar xf blackbox-notx.rar

ステージング ディレクトリには、以下のものが格納されます。

  • リソース アダプタを実装する Java クラスが入った jar ファイル

  • MANIFEST.MF および ra.xml ファイルが入った META-INF ディレクトリ

    以下のコマンドを実行してこれらのファイルを確認します。

    • 	c:/stagedir> ls
    		blackbox-notx.jar 
    		META-INF
    	c:/stagedir> ls META-INF
    		MANIFEST.MF
    		ra.xml

    1. weblogic-ra.xml ファイルを作成します。このファイルは、リソース アダプタ用の WebLogic 固有のデプロイメント記述子です。このファイルには、接続ファクトリ、接続プール、およびセキュリティ マッピングのパラメータを指定します。

      注意: RAR に weblogic-ra.xml ファイルが含まれない場合、WebLogic Server はこのファイルを自動的に作成します。詳細については、ra.xml ファイルのコンフィグレーション.を参照してください。

      weblogic-ra.xml ファイルの詳細については、weblogic-ra.xml ファイルのコンフィグレーションおよびweblogic-ra.xml デプロイメント記述子の要素を参照してください。

    2. weblogic-ra.xml ファイルを一時ディレクトリの META-INF サブディレクトリにコピーします。META-INF ディレクトリは、RAR を展開した一時ディレクトリ、またはリソース アダプタを展開ディレクトリ形式で格納しているディレクトリ内にあります。次のコマンドを使用します。
    	cp weblogic-ra.xml c:/stagedir/META-INF
    	c:/stagedir> ls META-INF
    		MANIFEST.MF
    		ra.xml
    		weblogic-ra.xml

    1. リソース アダプタ アーカイブを作成します。
    	jar cvf blackbox-notx.jar -C c:/stagedir

    1. WebLogic Server にリソース アダプタをデプロイします。WebLogic Server へのリソース アダプタのデプロイについては、リソース アダプタのパッケージ化とデプロイメントを参照してください。

     

    ra.xml ファイルのコンフィグレーション

    ra.xml ファイルがない場合は、手動で作成するか、または既存のファイルを編集して、リソース アダプタに必要なデプロイメント プロパティを設定します。プロパティの編集には、テキスト エディタを使用します。ra.xml ファイルの作成の詳細については、「J2EE コネクタ仕様、バージョン 1.0、最終リリース」(http://java.sun.com/j2ee/download.html#connectorspec) を参照してください。

     

    weblogic-ra.xml ファイルのコンフィグレーション

    標準リソース アダプタ コンフィグレーション ra.xml ファイルの機能サポートに加え、BEA WebLogic Server は追加デプロイメント記述子ファイルの weblogic-ra.xml ファイルを定義します。このファイルには、リソース アダプタを WebLogic Server でコンフィグレーションし、デプロイする作業に固有のパラメータが含まれます。このファイルは、WebLogic Server の EJB および Web アプリケーション用の拡張子 .xml のファイルと同じ機能を持つほか、WebLogic 固有のデプロイメント記述子をデプロイ可能なアーカイブに追加するものです。基本の RAR またはデプロイメント ディレクトリは、そのまま WebLogic Server にデプロイすることができません。最初に weblogic-ra.xml ファイルで、WebLogic Server 固有のデプロイメント プロパティを作成およびコンフィグレーションし、その XML ファイルをデプロイメントに追加する必要があります。

    weblogic-ra.xml ファイルには以下の属性を指定します。

    注意: weblogic-ra.xml のパラメータの設定については、weblogic-ra.xml デプロイメント記述子の要素の weblogic-ra.xml DTD を参照してください。ダウンロード製品に付属する Simple Black Box リソース アダプタ例に含まれている weblogic-ra.xml ファイルを参照することもできます。

    注意: リソース アダプタの接続プロパティのコンフィグレーションの詳細については、接続管理を参照してください。

    weblogic-ra.xml ファイルの自動生成

    WebLogic Server では、リソース アダプタ アーカイブ (RAR) に、J2EE コネクタ 1.0 仕様で指定された ra.xml デプロイメント記述子ファイルに加えて、weblogic-ra.xml デプロイメント記述子ファイルが必要です。ただし、リソース アダプタが weblogic-ra.xml ファイルを使用せずに WebLogic Server にデプロイされると、デフォルト要素値が含まれる weblogic-ra.xml テンプレート ファイルが自動的にリソース アダプタに追加されます。この自動リソース ファイル生成により、リソース アダプタを WebLogic Server にデプロイするために必要なパラメータを決定するプロセスが簡略化されます。

    RAR に weblogic-ra.xml ファイルが含まれない場合、WebLogic Server はこのファイルを自動的に作成します。この機能により、大幅な変更を加えなくてもサードパーティ製リソース アダプタを WebLogic Server にデプロイすることができます。変更の必要があるのは、WebLogic Server が weblogic-ra.xml ファイルに生成する 2 つのデフォルト属性の値、<connection-factory-name> と <jndi-name> だけです。

    これらのデフォルト値の変更方法については、weblogic-ra.xml デプロイメント記述子の要素.のAdministration Console デプロイメント記述子エディタを使用したファイルの編集を参照してください。

    生成された weblogic-ra.xml ファイルは、デフォルト値を変更する前には以下のようになります。

    コード リスト 5-1 weblogic-ra.xml のデフォルト値

    <weblogic-connection-factory-dd> 
    <connection-factory-name>__TMP_CFNAME_.¥config¥mydomain¥applications¥whitebox-notx.rar</connection-factory-name> 
    <jndi-name>__TMP_JNDINAME_.¥config¥mydomain¥applications¥whitebox-notx.rar</jndi-name> 
    	<pool-params> 
    		<initial-capacity>0</initial-capacity> 
    		<max-capacity>1</max-capacity> 
    		<capacity-increment>1</capacity-increment> 
    		<shrinking-enabled>false</shrinking-enabled> 
    		<shrink-period-minutes>200</shrink-period-minutes> 
    	</pool-params> 
    	<security-principal-map> 
    	</security-principal-map>
    </weblogic-connection-factory-dd>

    ra-link-ref 要素のコンフィグレーション

    オプションの <ra-link-ref> 要素を使用すると、デプロイ済みの複数のリソース アダプタを 1 つのデプロイ済みリソース アダプタに関連付けることができます。つまり、属性のサブセットを変更するだけで、基本リソース アダプタでコンフィグレーションされているリソースを別のリソース アダプタにリンク (再利用) できます。<ra-link-ref> 要素を使用すると、可能な場合、リソース (クラス、JAR、イメージ ファイルなど) の重複を防ぐことができます。デプロイ済みの基本リソース アダプタで定義されている値はすべて、<ra-link-ref> 要素でそれ以外の値が指定されていない限り、リンク先のリソース アダプタが継承します。

    オプションの <ra-link-ref> 要素を使用する場合は、<pool-params> 要素のすべての値を指定するか、まったく指定しないかのどちらかです。<pool-params> 要素は、基本リソース アダプタからリンク先のリソース アダプタに部分的には継承されません。

    以下のいずれかを実行します。

    weblogic-ra.xml ファイルの編集の詳細については、weblogic-ra.xml デプロイメント記述子の要素.のAdministration Console デプロイメント記述子エディタを使用したファイルの編集を参照してください。

     

    非推奨のセキュリティ プリンシパル マップ メカニズムのコンフィグレーション

    デフォルトの JAAS Login モジュールは、リソース アダプタ アーカイブ内の weblogic-ra.xml デプロイメント記述子に付属のセキュリティ プリンシパル マップ メカニズムに代わるものです。その結果、weblogic-ra.xml <security-principal-map> 要素は非推奨になりました。しかし、セキュリティ プリンシパル マップ メカニズムを使用する手順はそのまま残します。

    コンテナ管理によるサインオンを使用するには、WebLogic Server がリソース プリンシパルを識別してから、リソース プリンシパルに代わって EIS 接続を要求しなければなりません。WebLogic Server は、weblogic-ra.xml デプロイメント記述子ファイルの <security-principal-map> 要素で指定されているセキュリティ プリンシパル マップを探してリソース プリンシパルを識別します。

    このマップによって、WebLogic Server 開始プリンシパル (WebLogic Server セキュリティ レルムで定義された ID を持つユーザ) がリソース プリンシパル (リソース アダプタ/EIS システムに登録済みユーザ) と関連付けられます。

    また、<security-principal-map> を使用すると、実行時に識別された開始プリンシパルがマップ内に見つからない場合に適切なリソース プリンシパルにマップするデフォルトの開始プリンシパルを定義できます。以下のように、値が * の <initiating-principal> 要素を付けた <security-principal-map> でデフォルトの開始プリンシパルを設定します。

    <initiating-principal>*</initiating-principal>

    ユーザ名およびパスワードを指定する <security-principal-map> 要素には対応する <resource-principal> エントリも含める必要があります。

    次の例は、WebLogic Server 開始プリンシパルとリソース プリンシパルとの関連付けを示します。

    コード リスト 5-2 <initiating-principal> および <resource-principal> エントリの例

    <security-principal-map>
       <map-entry>
    	<initiating-principal>*</initiating-principal>
    	   <resource-principal>
    	       <resource-username>default</resource-username>
    		<resource-password>try</resource-password>
    	   </resource-principal>
       </map-entry>
    </security-principal-map>

    WebLogic Server が接続を初期化するよう接続プール パラメータで設定されている場合、デフォルトの開始プリンシパルはデプロイ時にも使用されます。デフォルトの開始プリンシパルのエントリがない場合、または <security-principal-map> 要素がない場合、WebLogic Server はコンテナ管理によるセキュリティを使用して接続を作成しません。

     

    非推奨のパスワード変換ツールの使い方

    デフォルトの JAAS ログイン モジュールがリソース アダプタ アーカイブ内の weblogic-ra.xml デプロイメント記述子に付属のセキュリティ プリンシパル マップ メカニズムに置き換わったため、パスワード変換ツールは非推奨になりました。しかし、パスワード変換ツールを使用する手順はこのリリースでもそのまま残します。

    WebLogic Server のリソース アダプタ用の以前のコンフィグレーションおよびパッケージ化の要件では、weblogic-ra.xml ファイルを手動で編集する必要があったため、security-principal-map エントリで指定する新しいパスワードはクリアテキストで指定されていました。

    このため、weblogic-ra.xml ファイルに存在するすべてのパスワードを暗号化するためのパスワード変換ツールを提供しています。変換ツールは、標準の weblogic.jar ファイルで提供されます。パスワード変換ツールは、クリアテキスト パスワードを含む既存の weblogic-ra.xml ファイルを解析し、暗号化されたパスワードを含む新しい weblogic-ra.xml ファイルを作成します。この新しいファイルは、WebLogic Server へのデプロイメント用に RAR にパッケージするファイルとなります。

    実行方法

    変換ツールを実行するには、DOS コマンド シェルで次の構文を使用します。

    コード リスト 5-3 変換ツールの構文

    java weblogic.Connector.ConnectorXMLEncrypt <input-weblogic-ra.xml> <output-weblogic-ra.xml> <domain-config-directory-location>

    セキュリティのヒント

    暗号化/解読処理に使用するドメイン固有のセキュリティのヒントでは、<domain config directory location> を含める必要があります。変換ツールにはこのドメイン固有のヒントを使用するよう指示しなければなりません。暗号化されたパスワードはこのドメインに固有のものです。したがって、暗号化されたパスワード値を持つ RAR は、そのドメインにのみデプロイ可能となります。

     

    トランザクション レベル タイプのコンフィグレーション

    リソース アダプタがサポートするトランザクション レベル タイプを ra.xml デプロイメント記述子ファイルに指定する必要があります。トランザクションのサポート レベルを指定するには次の手順に従います。

    .xml ファイルの編集の詳細については、weblogic-ra.xml デプロイメント記述子の要素.の「XML デプロイメント ファイルの手動による編集」および「Administration Console デプロイメント記述子エディタを使用したファイルの編集」を参照してください。

    RAR コンフィグレーションでのトランザクション レベルの指定方法については、「J2EE コネクタ仕様、バージョン 1.0、最終リリース」(http://java.sun.com/j2ee/download.html#connectorspec) で「Packaging and Deployment」の「Resource Adapter XML DTD」を参照してください。

     

    Back to Top Previous Next