Oracle® Fusion Middleware Oracle WebLogic ServerメッセージドリブンBeanのプログラミング 11g リリース1(10.3.3) B61425-01 |
|
前 |
この節では、MDBの動作に影響する主なデプロイメント要素をリストします。
表10-1は、weblogic-ejb-jar.xml
のmessage-driven-descriptor
要素のデプロイメント要素をまとめたものです。
表10-1 weblogic-ejb-jar.xmlのMDBのデプロイメント要素
要素 | 説明 | デフォルト値 |
---|---|---|
|
キューおよびトピックを作成するためにメッセージドリブンBeanがルックアップするJMS ConnectionFactoryのJNDI名。「connection-factory-jndi-nameの設定方法」を参照してください。 |
|
|
|
なし |
|
WebLogic Server JNDIツリーにデプロイされている実際のJMSキューまたはトピックにMDBを関連付けるために使用するJNDI名。「destination-jndi-nameの設定方法」を参照してください。 |
なし |
|
|
なし |
|
このオプションの要素を使用すると、Beanに特定のWorkManagerを指定できます。 |
なし |
|
同じクラスタ内のWebLogic JMS分散キューにアクセスするMDBが、リソースをすべての分散宛先メンバーから消費するか、現在のWeblogic Serverのローカル・メンバーのみから消費するかを指定します。 |
|
|
MDBがアンデプロイまたは削除されるときに恒久トピック・サブスクリプションが自動的に削除されるようにするかどうかを指定します。 |
|
|
EJBコンテナがMDBのすべてのインスタンスごとに一意のクライアントIDを生成するかどうかを指定します。このフラグを有効にすると、WebLogic Serverクラスタ内の複数のサーバー・インスタンスへの恒久MDBのデプロイが容易になります。 |
|
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する初期秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください。 |
|
|
起動時のWebLogic Serverに存在するMDBの非アクティブなインスタンスの数。 |
0 |
|
接続ファクトリの作成にEJBコンテナが使用する初期contextFactory。「initial-context-factoryの設定方法」を参照してください。 |
|
|
恒久サブスクライバ・トピックと関連付けられたメッセージドリブンBeanのクライアントID。『Oracle Fusion Middleware Oracle WebLogic Server JMSのプログラミング』の「クライアントIDの定義」を参照してください。 |
EJBの |
|
アクセスできなくなっているJMS宛先にEJBコンテナが再接続しようとする試みの秒間隔。「クラスタリングされたMDBの移行とリカバリ」を参照してください。 |
10秒 |
|
非アクティブなMDBの空きプールの最大サイズ。 |
1000 |
|
MDBのトランザクションに入れることができるメッセージの最大数を指定します。 |
なし |
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する最大秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください。 |
|
|
メッセージドリブンEJBのWebLogic Serverフリー・プールの動作を構成します。 |
なし |
|
InitialContextで使用されるURLプロバイダ。通常はホスト・ポート。「provider-urlの設定方法」を参照してください。 |
|
|
このMDBがメッセージを受け取るリソース・アダプタを指定します。 |
なし |
|
|
なし |
|
EJBタイマー・オブジェクト。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server Enterprise JavaBeansのプログラミング』の「EJBタイマー・サービスのプログラミング」を参照してください。 |
なし |
|
EJBのコンテナで初期化されたトランザクションの最長継続時間(秒単位)。この時間を過ぎると、トランザクションはロールバックされます。「MDBのトランザクション管理方式の構成」を参照してください。 |
|
|
WLSバージョン8.1方式のポーリングの下位互換性を有効にします。 |
False |
表9-2は、weblogic-application.xml
のejb
要素のMDBの主なデプロイメント要素のリストです。
表10-2 weblogic-application.xmlのMDBの要素
要素 | 説明 | デフォルト値 |
---|---|---|
|
MDBがいつメッセージの処理を開始するのかを制御します。デフォルト設定のtrueでは、WebLogic Serverが完全に起動していなくても、MDBはそのデプロイメントと同時にメッセージの処理を開始します。このため、MDBアプリケーションは起動の途中で初期化されていないサービスやアプリケーションにアクセスし、失敗することがあります。 falseに設定すると、WebLogic Serverがそのリスニング・ポートを開くまでメッセージの処理が延期されます。 |
|
表9-3は、ejb-jar.xml
のmessage-driven
要素で構成するMDBの主なJ2EEデプロイメント要素のリストです。
表10-3 MDBの主要なJ2EEデプロイメント要素
要素 | 説明 | 有効な値 |
---|---|---|
|
Bean管理のトランザクションの境界設定を使用するメッセージドリブンBeanの |
|
|
操作環境でのメッセージドリブンBeanの構成プロパティとして想定される情報を定義します。確認応答、メッセージ・セレクタ、想定される宛先タイプなどの情報を含めることができます。 構成情報は、名前/値構成プロパティで表現します。 |
特定のメッセージドリブンBeanでどのプロパティが識別されるかは、そのメッセージ・タイプによって決まります。 |
|
JMS宛先のタイプ(宛先で実装されるJavaインタフェース)を指定します。 |
|
|
宛先のタイプを指定します。 |
宛先での実装が想定されるJavaインタフェースで指定します。 |
|
このメッセージドリブンBeanのメッセージ・リスナー・インタフェースを指定します。 |
有効なメッセージ・リスナー・インタフェース。 |
|
JMSトピック・サブスクリプションが恒久かそうでないかを指定します。 |
|
|
エンタープライズBeanのトランザクションの管理タイプを指定します。 注意: transaction-typeがContainerに設定されている場合、trans-attributeはRequiredに設定する必要があります。 |
|
|
メソッドの呼出しをエンタープライズBeanのビジネス・メソッドに委託するときにコンテナがトランザクションの境界をどのように管理するのかを指定します。 コンテナ管理によるトランザクションでは、 |
|
表10-4は、WebLogic ServerでサポートされるactivationConfig
の名前と値のペアをまとめたものです。
表10-4 activationConfigのプロパティ
ActivationConfigPropertyのプロパティ名 | 説明 | デフォルト値 |
---|---|---|
|
キューおよびトピックを作成するためにメッセージドリブンBeanがルックアップするJMS ConnectionFactoryのJNDI名。「connection-factory-jndi-nameの設定方法」を参照してください。 |
|
|
|
なし |
|
WebLogic Server JNDIツリーにデプロイされている実際のJMSキューまたはトピックにMDBを関連付けるために使用するJNDI名。「destination-jndi-nameの設定方法」を参照してください。 |
なし |
|
|
なし |
|
同じクラスタ内のWebLogic JMS分散キューにアクセスするMDBが、リソースをすべての分散宛先メンバーから消費するか、現在のWeblogic Serverのローカル・メンバーのみから消費するかを指定します。 |
|
|
MDBがアンデプロイまたは削除されるときに恒久トピック・サブスクリプションが自動的に削除されるようにするかどうかを指定します。 |
|
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する初期秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください。 |
|
|
接続ファクトリの作成にEJBコンテナが使用する初期contextFactory。「initial-context-factoryの設定方法」を参照してください。 |
|
|
恒久サブスクライバ・トピックと関連付けられたメッセージドリブンBeanのクライアントID。『Oracle Fusion Middleware Oracle WebLogic Server JMSのプログラミング』の「クライアントIDの定義」を参照してください。 |
EJBの |
|
アクセスできなくなっているJMS宛先にEJBコンテナが再接続しようとする試みの秒間隔。「クラスタリングされたMDBの移行とリカバリ」を参照してください。 |
10秒 |
|
MDBのトランザクションに入れることができるメッセージの最大数を指定します。 |
なし |
|
EJBコンテナがJMSリソースの停止を検出したときにMDBのJMS接続を中断する最大秒数。「JMSリソース停止中のメッセージ配信の中断の構成」を参照してください。 |
|
|
InitialContextで使用されるURLプロバイダ。通常はホスト・ポート。「provider-urlの設定方法」を参照してください。 |
|
|
このMDBがメッセージを受け取るリソース・アダプタを指定します。 |
なし |
|
WLSバージョン8.1方式のポーリングの下位互換性を有効にします。 |
False |