ページの先頭行へ戻る
Interstage Application Server V12.0.0 Java EE 7 設計・構築・運用ガイド
FUJITSU Software

2.9.2 Message-driven Beanの実行環境

Message-driven Beanは、JMSメッセージまたはリソースアダプタのメッセージを受信して処理するEJBアプリケーションです。

EJBコンテナは、Message-driven Beanが対象とする宛先にメッセージが到着すると、そのメッセージを受信してMessage-driven Beanのインスタンスを呼び出してビジネスロジックを実行します。
Message-driven Beanに記述されたメッセージリスナーメソッド(JMSの場合はonMessageメソッド)でメッセージを処理します。Message-driven Beanは、Session BeanまたはJava Persistence APIを呼び出すか、DBMSが提供するデータベース操作命令(JDBCドライバ)を直接呼び出してデータベース処理を行います。
Message-driven Bean のインスタンスは、プールで管理されます。プールの詳細については、「6.5.3 Enterprise Beanインスタンスのプーリング」を参照してください。

以下にMessage-driven Beanの位置づけを示します。以下はJMSメッセージを受信する場合の構成図です。



Message-driven Beanはメッセージを受信する対象としてJMSからメッセージを受信するか、リソースアダプタからメッセージを受信するか選択できます。

JMSからメッセージを受信する場合

JMSからメッセージを受信する場合、Message-driven Beanがメッセージ受信対象とする定義済みの以下の2つを指定する必要があります。

以下にそれぞれの指定方法について説明します。


JMS接続ファクトリの指定

JMSプロバイダにアクセスするには、JMS接続ファクトリが必要です。Message-driven Beanが対象とするJMS接続ファクトリを指定することで、JMS接続ファクトリのコネクションプールをチューニングできます。JMS接続ファクトリを指定しなかった場合には、コネクションプールのチューニング項目がデフォルト設定のJMS接続ファクトリが内部的に使用されます。

Message-driven Beanが対象とするJMS接続ファクトリを指定するには、JMS接続ファクトリのJNDI名をInterstage EJB application deployment descriptor (glassfish-ejb-jar.xml)ファイルの<ejb><mdb-connection-factory>タグに指定します。
定義詳細については、「3.2.1.3 Interstage EJB application deployment descriptor (glassfish-ejb-jar.xml)」を参照してください。JMS接続ファクトリの作成方法とチューニング機能については、「4.15.5 JMSのメッセージを送受信する準備」を参照してください。


JMS送信先リソースの指定

Message-driven Beanが使用するJMS送信先リソースのJNDI名を指定します。
JMS送信先リソースの作成については、「4.15.5 JMSのメッセージを送受信する準備」を参照してください。
Message-driven Beanが使用するJMS送信先リソースの指定場所を、以下に示します。

定義の優先度

指定場所

使用パターン

1

glassfish-ejb-jar.xmlファイルの<ejb>の<jndi-name>

EJB 2.1以前のEJBアプリケーションを使用する場合、または以下の定義を修正せずに上書きしたい場合。

2

ejb-jar.xmlファイルの<message-driven-bean>の<mapped-name>

アノテーションを使用しない、または上書きしたい場合。

3

ソース内の@MessageDrivenのmappedName属性

開発時にアノテーションを採用し運用環境上のJNDI名が既知の場合。


サブスクライバ識別名の指定

Message-driven BeanがPublish/Subscribeモデルの場合は、サブスクライバの永続性をdeployment descriptor(ejb-jar.xml)ファイルの<message-driven><subscription-durability>タグに指定できます。サブスクライバの永続性の詳細については、EJB規約を参照してください。

サブスクライバの永続性を「Durable」に指定する場合は、サブスクライバの識別名をInterstage EJB application deployment descriptor (glassfish-ejb-jar.xml)ファイルの<ejb><jms-durable-subscription-name>タグに指定します。定義詳細については、「3.2.1.3 Interstage EJB application deployment descriptor (glassfish-ejb-jar.xml)」を参照してください。


注意

IJServerクラスタを複数プロセス構成で運用する場合の注意事項

IJServerクラスタを複数プロセス構成で運用すると、Message-driven Beanは複数のセッションを使用してメッセージを受信するため、複数メッセージを並行に処理するためにメッセージ順序性は保証されません。

Publish/Subscribeモデルでは複数の受信者に対して同一のメッセージが配信されますが、IJServerクラスタを複数プロセス構成で運用する場合は、Topicからのメッセージを1つのプロセスで動作しているMessage-driven Beanにのみ送信します。


サブスクライバの永続性を「Durable」に指定する場合の注意事項

サブスクライバの永続性を「Durable」に指定した場合、Message-driven Beanの初回起動時に「サブスクライバの識別名」に設定された名前で永続サブスクリプションを登録します。永続サブスクリプションが必要なくなった場合は、imqcmd destroy durコマンドで削除してください。


JMS送信先リソースの指定に関する注意事項

メッセージブローカに、Message-driven Beanが使用するJMS送信先リソースに設定された物理格納先が存在しない場合、Message-driven Beanの起動時に物理格納先が作成されます。

物理格納先を適切に管理するために、本運用を行う場合は、Message-driven Beanを起動する前に、imqcmdコマンドを使用して物理格納先を作成することを推奨します。コマンドの詳細については、「10.6.1 create dstサブコマンド」を参照してください。

リソースアダプタからメッセージを受信する場合

リソースアダプタからメッセージを受信する場合、Interstage EJB application deployment descriptor(glassfish-ejb-jar.xml)の<resource-adapter-mid>タグに使用するリソースアダプタ名を指定します。<resource-adapter-mid>タグを指定しない場合、または空の文字列か「jmsra」を指定した場合は、メッセージを受信する対象としてJMSが選択されます。リソースアダプタ名については「4.16.1 コネクタモジュールの配備とリソース定義の作成」を、定義詳細については「3.2.1.3 Interstage EJB application deployment descriptor (glassfish-ejb-jar.xml)」を参照してください。
チューニング機能、複数プロセスでの運用や使用時の注意事項については、リソースアダプタ提供元のマニュアルも参照してください。