11 MDBのデプロイメント要素とアノテーション
表11-1の各行は、デプロイメント要素(EJBデプロイメント記述子で使用)およびそれに関連する構成プロパティ(アノテーションで指定)を記載しています。すべての要素が関連プロパティを持つとは限りません。
デプロイメント記述子の使用とMDBのアノテーションの詳細は、「EJB 3.2準拠MDBのプログラミング」を参照してください。
ノート:
関連構成プロパティを持つ要素の場合、要素のかわりに該当するプロパティを使用することをお薦めします。表11-1は、次のように構成されています。
-
要素列の各要素の後には、カッコの中に要素が使用されるデプロイメント記述子名が続きます。
weblogic-ejb-jar.xml記述子の要素は、『Oracle WebLogic Server Enterprise JavaBeansバージョン2.1の開発』の「weblogic-ejb-jar.xmlデプロイメント記述子のリファレンス」に記載されている要素の詳細説明にリンクしています。ejb-jar.xmlの要素については、http://www.oracle.com/webfolder/technetwork/jsc/xml/ns/javaee/ejb-jar_3_2.xsdでスキーマを参照してください。 -
特に断りのないかぎり、構成プロパティ列にリスト表示されているすべてのプロパティは、アクティブ化構成プロパティです。つまり、
ejb-jar.xml記述子のmessage-drivenスタンザにある@ActivationConfigPropertyアノテーションまたはactivation-config-property要素を使用して定義されたプロパティです。@ActivationConfigPropertyの使用に関する詳細は、EJB 3.2準拠MDBのプログラミングに関する項を参照してくださいノート:
Enterprise JavaBean仕様に基づき、
javax.ejb.ActivationConfigPropertyアノテーションはMDBでのみ使用されます。このアノテーションは、セッションまたはエンティティBeanでは使用されません。 -
また、構成プロパティ列は、アノテーションや
@ActivationConfigPropertyプロパティ以外のプロパティもリストしています。これらの場合、プロパティの後にはアノテーション名および当該アノテーションの使用に必要なimport文が続きます。
表11-1 MDBのデプロイメント要素とアノテーション
| 要素 | 構成プロパティ | 説明 | 有効な値 | デフォルト値 |
|---|---|---|---|---|
|
( |
|
メッセージが受信および処理されたことをJMSプロバイダに通知します。コンテナ管理トランザクションを使用する場合は、確認応答モードは無視されます。(確認応答はトランザクションのコンテキストで実行されます。) |
|
|
|
( |
|
JMSメッセージドリブンBeanのメッセージの受信元であるJMSプロバイダに接続するために使用するJMS接続ファクトリのルックアップ名。 |
有効なルックアップ名 |
|
|
( |
|
キューおよびトピックを作成するためにMDBがルックアップするJMS ConnectionFactoryのJNDI名。「connection-factory-jndi-nameの設定方法」を参照してください |
有効なJNDI名 |
|
|
( |
|
|
JMSモジュール内の有効なリソース |
なし |
|
( |
|
JMSメッセージドリブンBeanのメッセージの受信元であるJMSキューまたはトピックのルックアップ名。 |
有効なルックアップ名 |
なし |
|
( |
|
Oracle WebLogic Server JNDIツリーにデプロイされている実際のJMSキューまたはトピックにMDBを関連付けるために使用するJNDI名。「destination-jndi-nameの設定方法」を参照してください |
有効なJNDI名 |
なし |
|
( |
|
|
JMSモジュール内の有効なリソース |
なし |
|
( |
なし |
このオプション要素を使用すると、Beanに特定のWorkManagerを指定できるようになります。『Oracle WebLogic Serverのパフォーマンスのチューニング』のメッセージドリブンBeanのチューニングに関する項 を参照してください。 |
有効な実行キューの名前 |
なし |
|
( |
|
同一クラスタ内のWebLogic JMS分散宛先(トピックまたはキュー)にアクセスするMDBが、すべての分散宛先メンバーから消費するか、または現在のOracle WebLogic Serverインスタンスに対してローカルの分散宛先メンバーのみから消費するかを指定します。すべてのユース・ケースに適用することはできません。JMS分散宛先およびJMSトピックを使用したMDBの構成とデプロイを参照してください。 |
|
|
|
( |
|
MDBがアンデプロイまたは削除されるときに恒久トピック・サブスクリプションが自動的に削除されるようにするかどうかを指定します。 |
|
|
|
( |
|
EJBコンテナが一意の |
|
|
|
( |
なし |
フリー・プールの初期サイズを設定します。Oracle WebLogic Serverは起動時に、Beanクラスごとに指定された数のBeanインスタンスをフリー・プールに格納します。この方法でBeanインスタンスをフリー・プールに格納しておくと、要求が来てから新しいインスタンスを生成せずにBeanに対する初期リクエストが可能になるため、MDBの初期レスポンス時間が短縮されます。 |
|
0 |
|
( |
|
接続ファクトリの作成にEJBコンテナが使用する初期コンテキスト・ファクトリ。「initial-context-factoryの設定方法」を参照してください |
初期コンテキスト・ファクトリの有効な名前 |
|
|
( |
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する初期秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください |
任意の整数 |
|
|
( |
|
JMSメッセージドリブンBeanのメッセージの受信元であるJMSプロバイダに接続する際に使用するクライアントID。 |
なし |
|
|
( |
|
JMS宛先に接続時のMDBのクライアントID。オプションです。JMSトピックへの恒久サブスクリプションに使用されます。詳細は、トピック・サブスクリプション識別子を参照してください。 |
なし |
|
|
( |
|
アクセスできなくなっているJMS宛先にEJBコンテナが再接続しようとする試みの秒間隔。「クラスタ化MDBの移行とリカバリ」を参照してください |
任意の整数 |
|
|
( |
なし |
MDBフリー・プール内のBeanインスタンスの最大数。また、インスタンスの実際の数は、スレッド・プール・サイズおよびその他の要因によっても制限されます。『Oracle WebLogic Serverのパフォーマンスのチューニング』のメッセージドリブンBeanのチューニングに関する項 を参照してください。 |
|
1000 |
|
( |
|
MDBのトランザクションに入れることができるメッセージの最大数を指定します。 |
すべての正の整数 |
なし |
|
( |
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する最大秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください |
任意の整数 |
|
|
( |
|
JMS宛先のタイプ(宛先で実装されるJavaインタフェース)を指定します。 |
|
なし |
|
( |
|
非同期セッション向けに存在でき、メッセージ・リスナーにまだ渡されていないメッセージの最大数。値 メッセージ数が特定の値に到達すると、次の対応が行われます。
マルチキャスト・セッションでは、接続が停止された場合、メッセージは蓄積され続けますが、指定された最大値に到達するまでの間にかぎられます。一度最大値に達すると、メッセージは超過時のポリシーに基づいて破棄されます。 |
|
|
|
( |
|
ヘッダー・フィールド参照およびプロパティ参照ごとに、関連のあるメッセージを指定するためにクライアントによって使用される文字列。ヘッダーとプロパティ値がセレクタに一致するメッセージのみが送信されます。 |
メッセージ・プロパティまたはメッセージ・ヘッダーを使用する条件式 |
NULL |
|
( |
なし |
ほとんど使用されません。 |
|
なし |
|
( |
|
|
有効なURL |
NULL |
|
( |
|
JCAドリブンMDBの場合、このMDBがメッセージを受信する元のリソース・アダプタを識別します。 |
なし |
なし |
|
( |
なし |
|
なし |
なし |
|
( |
なし |
MDBがいつメッセージの処理を開始するのかを制御します。 falseに設定すると、Oracle WebLogic Serverがそのリスニング・ポートを開くまでメッセージの処理が延期されます。 |
|
|
|
( |
|
JMSトピック・サブスクリプションが |
|
|
|
( |
|
トピックにパブリッシュされたメッセージを受信するように想定されている場合のサブスクリプション名。恒久または非恒久トピック・サブスクライバにこのプロパティを設定できます。 |
なし |
なし |
|
なし |
|
トピック・メッセージの配信モードを設定します。JMSトピックを使用したMDBの構成とデプロイを参照してください。 |
|
|
|
( |
「trans-attribute」を参照してください |
エンタープライズBeanのトランザクション管理タイプを指定します。詳細は、「MDBのトランザクション管理戦略の構成」を参照してください |
|
|
|
( |
import javax.ejb.TransactionAttribute @TransactionAttribute(TransactionAttributeType.REQUIRED) |
メソッドの呼出しをエンタープライズBeanのビジネス・メソッドに委託するときにコンテナがトランザクションの境界をどのように管理するのかを指定します。 ノート: Beanがコンテナ管理トランザクションの境界設定を使用すると指定されている場合、 |
|
|
|
( |
|
EJBのコンテナで初期化されたトランザクションの最長継続時間(秒単位)。この時間を過ぎると、トランザクションはロールバックされます。「MDBのトランザクション管理戦略の構成」を参照してください |
|
トランザクション・タイムアウトが指定されていない、または |
|
( |
|
Oracle WebLogic Serverバージョン8.1方式のポーリングの後方互換性を有効にします。 |
|
False |
|
|
|
AQ JMSがMDBのJMSプロバイダで、このプロパティがtrueに設定されている場合、同期ポーリングは |
|
False |
|
|
|
JMS宛先にメッセージがなく、MDBに対して同期ポーリングが使用されている場合、このプロパティはメッセージ・ポーリング間隔をミリ秒で設定します。MDBがAQ JMSと相互運用し、minimizeAQSessionsがtrueに設定されている場合、このプロパティを5000より大きい値に設定することでデータベース接続使用のバーストを回避できます。この構成では、複数のMDBが開始されると、ランダムにメッセージ・ポーリングを開始します。
|
0以上(整数) |
0 |
|
|
|
このプロパティは、MDBがAQ JMSと相互作用する場合にのみ使用されます。このプロパティがtrueに設定されると、動的にAQ JMSセッションを終了することでデータベース・リソースの使用を減らします。 |
|
False |