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://java.sun.com/xml/ns/javaee/ejb-jar_3_0.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 |