ORACLE JAPAN Server Release 6.1

 
  |  

  WebLogic Server ホーム   |     WebLogic J2EE コネクタ アーキテクチャ   |   前へ   |   次へ   |   目次   |   索引   |   PDF 版

weblogic-ra.xml デプロイメント記述子の要素

 

以下の節では、WebLogic Server リソース アダプタ アーカイブで使用する WebLogic Server 6.1 固有の全 XML デプロイメント プロパティをリファレンス形式で示し、XML デプロイメント プロパティを手動で編集する方法について説明します。リソース アダプタ用のデプロイメント記述子を参照する必要がある場合は、これらの節を参考にしてください。

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

 

XML デプロイメント ファイルの手動による編集

WebLogic Server のリソース アダプタ アーカイブで使用される XML デプロイメント記述子を定義または変更する場合は、weblogic-ra.xml ファイルで XML 要素を手動で定義または編集する必要があります。

基本規約

XML 要素を手動で編集する場合は、

DOCTYPE ヘッダ情報

XML デプロイメント ファイルの編集、作成時に、各デプロイメント ファイルに対して正しい DOCTYPE ヘッダを指定することが重要です。特に、DOCTYPE ヘッダ内部に不正な PUBLIC 要素を使用すると、原因究明が困難なパーサ エラーになることがあります。

このヘッダは、デプロイメント記述子の文書型定義（DTD）ファイルの場所およびバージョンを表します。このヘッダは外部 URL の java.sun.com を参照していますが、WebLogic Server には独自の DTD ファイルが用意されているので、ホスト サーバがインターネットにアクセスする必要はありません。ただし、この要素の DTD のバージョンはデプロイメント記述子のバージョンの識別に使用されるので、<!DOCTYPE...> 要素を ra.xml ファイルに含めて、外部 URL を参照させる必要があります。

ra.xml および weblogic-ra.xml ファイルの DOCTYPE ヘッダ全体は以下のようになります。

XML ファイル

DOCTYPE ヘッダ

ra.xml

<!DOCTYPE connector PUBLIC
'-//Sun Microsystems, Inc.//DTD Connector 1.0//EN'
'http://java.sun.com/dtd/connector_1_0.dtd'>

weblogic-ra.xml

<!DOCTYPE connector PUBLIC

'-//BEA Systems, Inc.//DTD WebLogic 6.0.0 Connector//EN' 'http://www.bea.com/servers/wls600/dtd/weblogic600-ra.dtd'

XML の解析ユーティリティ（ejbc など）でヘッダ情報が不正な XML ファイルを解析すると、次のようなエラー メッセージが表示されることがあります。

SAXException: This document may not have the identifier 'identifier_name'

identifier_name には通常、PUBLIC 要素内の不正な文字列が表示されます。

検証用 DTD（Document Type Definitions : 文書型定義）

XML ファイルの内容および要素の配置は、使用する各ファイルの文書型定義（DTD）に準拠している必要があります。WebLogic Server ユーティリティでは、XML デプロイメント ファイルの DOCTYPE ヘッダ内に埋め込まれた DTD は無視され、代わりにサーバと共にインストールされた DTD の場所が使用されます。ただし、DOCTYPE ヘッダ情報には、パーサ エラーを避けるために有効な URL 構文を指定する必要があります。

以下のリンクでは、WebLogic Server で使用される XML デプロイメント ファイル用の DTD の場所が示されています。

注意: ほとんどのブラウザでは、.dtd ファイルの内容は表示されません。DTD ファイルの内容をブラウザで見るには、リンクをテキスト ファイルとして保存し、テキスト エディタで開いて表示します。

 

Administration Console デプロイメント記述子エディタを使用したファイルの編集

この節では、Administration Console のデプロイメント記述子エディタを使用して以下のリソース アダプタのデプロイメント記述子を編集する手順を説明します。

リソース アダプタ デプロイメント記述子の要素の詳細については、『WebLogic J2EE コネクタ アーキテクチャ』を参照してください。

リソース アダプタのデプロイメント記述子を編集するには、次の手順に従います。

  1. ブラウザで次の URL を指定して、Administration Console を起動します。

    http://host:port/console

    host は WebLogic Server が実行されているコンピュータ名で、port はリスンしているポート番号を表します。

  2. 左ペインの [デプロイメント] ノードをクリックして展開します。

  3. [デプロイメント] ノードの [コネクタ] ノードをクリックして展開します。

  4. 編集対象のデプロイメント記述子があるリソース アダプタの名前を右クリックし、ドロップダウン メニューから [コネクタ記述子の編集] を選択します。

    Administration Console ウィンドウが新しいブラウザに表示されます。左側のペインでは、2 つのリソース アダプタのデプロイメント記述子のすべての要素がツリー形式で表示され、右側のペインには、ra.xml ファイルの説明要素のためのフォームがあります。

  5. リソース アダプタのデプロイメント記述子の要素を編集、削除、または追加するには、以下のリストで説明されているように、左側のペインで編集対象のデプロイメント記述子に対応するノードをクリックして展開します。

  6. いずれかのリソース アダプタ デプロイメント記述子の既存の要素を編集するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、編集対象の要素が見つかるまで親要素をクリックします。

    2. 要素をクリックします。右側のペインに、属性または下位要素のどちらかをリストするフォームが表示されます。

    3. 右側のペインのフォームで、テキストを編集します。

    4. [適用] をクリックします。

  7. いずれかのリソース アダプタ デプロイメント記述子の新しい要素を追加するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、作成対象の要素の名前が見つかるまで親要素をクリックします。

    2. 目的の要素を右クリックして、ドロップダウン メニューから [新しい（要素名）のコンフィグレーション] を選択します。

    3. 右側のペインに表示されるフォームで、要素情報を入力します。

    4. [作成] をクリックします。

  8. いずれかのリソース アダプタ デプロイメント記述子の既存の要素を削除するには、次の手順に従います。

    1. 左側のペインでツリーをナビゲートし、削除対象の要素の名前が見つかるまで親要素をクリックします。

    2. 目的の要素を右クリックして、ドロップダウン メニューから [（要素名）の削除] を選択します。

    3. [はい] をクリックすると、要素の削除が確定されます。

  9. リソース アダプタ デプロイメント記述子への変更がすべて完了したら、左側のペインでツリーのルート要素をクリックします。ルート要素は、リソース アダプタの *.rar アーカイブ ファイルの名前またはリソース アダプタの表示名です。

  10. リソース アダプタ デプロイメント記述子のエントリが有効かどうかを確認する場合は、[検証] をクリックします。

  11. [永続化] をクリックして、デプロイメント記述子ファイルの編集を、WebLogic Server のメモリだけでなくディスクに書き込みます。

 

weblogic-ra.xml DTD

コード リスト A-1 weblogic-ra.xml DTD

weblogic-ra.xml の DTD
<!--
Weblogic 固有のリソース アダプタ デプロイメント記述子 1.0 用の XML DTD
-->
<!--
この DTD は、デプロイ済みリソース アダプタの接続ファクトリを定義するための
 Weblogic 固有のデプロイメント情報を定義します。この要素は、接続プール 
パラメータを始めとしてコンフィグレーション可能なすべての接続ファクトリ 
パラメータおよびリソース プリンシパル マップ用のセキュリティ パラメータを
指定し、 ra.xml デプロイメント記述子のコンフィグレーション パラメータの値を
定義する機能を提供します。
-->
Copyright (c) 2001 by BEA Systems, Inc. All Rights Reserved.
<!--
weblogic-connection-factory-dd 要素は Weblogic 固有のデプロイメント
記述子のルート要素で、デプロイ済みリソース アダプタ用です。
-->
<!ELEMENT weblogic-connection-factory-dd (connection-factory-name,
 description?, jndi-name, ra-link-ref?, native-libdir?,
 pool-params?, logging-enabled?, log-filename?,
 map-config-property*, security-principal-map?)>
<!--
connection-factory-name 要素は、特定のリソース アダプタのデプロイメ
connection-factory-name の値は、ra-link-ref 要素を介して他のデプロイ済
みリソース アダプタで使用できます。これにより、複数のデプロイ済み接続ファクト
リ間で、指定されているコンフィグレーションを共有するだけでなく、共通の
デプロイ済みリソース アダプタを利用することもできます。
この要素は必須です。
-->
<!ELEMENT connection-factory-name (#PCDATA)>
<!--
description 要素は、親要素を示すテキストの指定に使用します。description 
要素には、デプロイヤがデプロイ済みファクトリについて説明するための情報を含め
ます。
この要素は省略できます。
-->
<!ELEMENT description (#PCDATA)>
<!--
jndi-name 要素は、接続ファクトリ オブジェクトを Weblogic JNDI ネーム
スペースにバインドするための名前を定義します。クライアント EJB および
サーブレットも、weblogic 固有のデプロイメント記述子で定義されている
 Reference Descriptor 要素でこの JNDI を使用します。
この要素は必須です。
-->
<!ELEMENT jndi-name (#PCDATA)>
<!--
ra-link-ref では、複数のデプロイ済み接続ファクトリを 1 つのデプロイ済み
リソース アダプタに論理的に関連付けることができます。オプションの ra-link-ref
 要素に別のデプロイ済み接続ファクトリを示す値を指定すると、新しくデプロイされ
る接続ファクトリが、参照先の接続ファクトリと一緒にデプロイされたリソース 
アダプタを共有します。
また、参照先の接続ファクトリのデプロイメントで定義されているすべての値は、
その他の値が指定されていない限り、新しくデプロイされるこの接続ファクトリが
継承します。
この要素は省略できます。
-->
<!ELEMENT ra-link-ref (#PCDATA)>
<!--
native-libdir 要素は、このリソース アダプタ デプロイメントのすべての
ネイティブ ライブラリ用に使用するディレクトリの場所を示します。デプロイメント
処理の一部として、検出されたネイティブ ライブラリはすべて指定された場所に
コピーされます。
管理者は、Weblogic Server の実行中にライブラリが見つかるようにプラット
フォームのアクションを実行する必要があります。
この要素は、ネイティブ ライブラリが存在する場合には必須です。
-->
<!ELEMENT native-libdir (#PCDATA)>
<!--
pool-params 要素は、この接続ファクトリの接続プール固有のパラメータを
指定するための親要素です。
Weblogic は、管理対象の接続が保持するプールの動作を制御する際にこれらの指定
を使用します。
この要素は省略できます。この要素またはこの要素に固有の項目を指定しないと、
デフォルト値が割り当てられます。指定されているデフォルト値については、
それぞれの要素の説明を参照してください。
-->
<!ELEMENT pool-params (initial-capacity?, max-capacity?,
 capacity-increment?, shrinking-enabled?, shrink-period-minutes?,
 connection-cleanup-frequency?, connection-duration-time?)>
<!--
initial-capacity 要素は、管理対象の接続の初期数を示します。Weblogic
 Server はデプロイメント中にこの数の接続を取得しようとします。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 : 1
-->
<!ELEMENT initial-capacity (#PCDATA)>
<!--
max-capacity 要素は、Weblogic Server が許容する管理対象の接続の最大数を
示します。この制限を超えて管理対象の接続の割り当てを要求すると、呼び出し側に
 ResourceAllocationException が返されます。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 : 10
-->
<!ELEMENT max-capacity (#PCDATA)>
<!--
capacity-increment 要素は、管理対象の接続の追加数を示します。Weblogic
 Server は、保持している接続プールのサイズを変更する際にこの数の接続を取得
しようとします。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 : 1
-->
<!ELEMENT capacity-increment (#PCDATA)>
<!--
shrinking-enabled 要素は、接続プールがシステム リソースの管理手段として
未使用の管理対象接続を再利用するかどうかを示します。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
値の範囲 :true または false
デフォルト値 :true
-->
<!ELEMENT shrinking-enabled (#PCDATA)>
<!--
shrink-period-minutes 要素は、接続プール管理によって未使用の管理対象接続
を再利用しようとする間隔を示します。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 : 15
-->
<!ELEMENT shrink-period-minutes (#PCDATA)>
<!--
connection-cleanup-frequency 要素は、接続プール管理によって設定されて
いる使用時間を超えた接続ハンドルを破棄しようとする間隔（秒単位）を示します。
この要素は connection-duration-time と連携して、アプリケーションが使用後
の接続を閉じなかった場合に接続リークを防ぎます。
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 :	-1
-->
<!ELEMENT connection-cleanup-frequency (#PCDATA)>
<!--
connection-duration-time 要素は、接続ハンドルがアクティブな状態を続ける
時間（秒単位）を示します。この要素は connection-cleanup-frequency と
連携して、アプリケーションが使用後の接続を閉じなかった場合にリークを防ぎます。 
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
デフォルト値 :	-1
-->
<!ELEMENT connection-duration-time (#PCDATA)>
<!--
logging-enabled 要素は、ManagedConnectionFactory または
 ManagedConnection に対してログ ライタが設定されているかどうかを示します。
この要素を true に設定すると、ManagedConnectionFactory または
 ManagedConnection から生成された出力は、log-filename 要素で指定した
ファイルに送られます。 
この要素は省略できます。
この値を指定しないと、Weblogic は定義されているデフォルト値を使用します。
値の範囲 :true または false
デフォルト値 :false
-->
<!ELEMENT logging-enabled (#PCDATA)>
<!--
log-filename 要素は、ManagedConnectionFactory または
 ManagedConnection から生成された出力を送るログ ファイルの名前を指定します。
ファイル名は絶対アドレスで指定する必要があります。
この要素は省略できます。
-->
<!ELEMENT log-filename (#PCDATA)>
<!--
各 map-config-property 要素は、対応する config-property-name 名を持つ
 ra.xml の config-entry 要素に対応するコンフィグレーション プロパティの
名前および値を示します。
デプロイメント時には、map-config-property で指定されたすべての値が
 ManagedConnectionFactory で設定されます。
map-config-property を介して指定された値は、対応する ra.xml の
 config-entry 要素で指定されたデフォルト値に優先します。
この要素は省略できます。
-->
<!ELEMENT map-config-property (map-config-property-name,
 map-config-property-value)>
<!ELEMENT map-config-property-name (#PCDATA)>
<!ELEMENT map-config-property-value (#PCDATA)>
<!--
各 security-principal-map 要素は、Weblogic 実行時の既知の開始
プリンシパルに基づいて、リソース アダプタ/EIS の許可処理用のリソース 
プリンシパル値を定義するためのメカニズムを提供します。
このマップにより、管理対象の接続と接続ハンドルを割り当てる際に使用される
開始プリンシパルと対応するリソース プリンシパルのユーザ名およびパスワードの
セットを指定できます。
デフォルトのリソース プリンシパルは、このマップに基づいて接続ファクトリ用に
定義できます。initiating-principal 値に「*」を指定し、対応する
 resource-principal 値を指定した場合、マップ内で現在の ID と一致する
ものがないときには必ず定義した resource-principal が利用されます。
この要素は省略できますが、コンテナ管理によるサインオンがリソース アダプタで
サポートされており、いずれかのクライアントで使用される場合は指定する必要が
あります。
また、デプロイ時に管理対象の接続を接続プールに取得する試みは、定義されている
「デフォルト」リソース プリンシパル（指定されている場合）を使用して行われます。
-->
<!ELEMENT security-principal-map (map-entry*)>
<!ELEMENT map-entry (initiating-principal+, resource-principal)>
<!ELEMENT initiating-principal (#PCDATA)>
<!ELEMENT resource-principal (resource-username,
 resource-password)>
<!ELEMENT resource-username (#PCDATA)>
<!ELEMENT resource-password (#PCDATA)>

 

weblogic-ra. xml の要素の階層図

以下の図は、weblogic-ra.xml デプロイメント記述子の構造を示しています。

図 A-1 weblogic-ra.xml の要素の階層


 

 

weblogic-ra.xml の要素の説明

以降の節では、weblogic-ra.xml ファイル内に表示される各要素について説明します。

 

back to top previous page next page