メッセージ駆動型 Bean の JNDI 名の定義に WebSphere バインディングを使用する

message-driven-descriptor は、メッセージ・リスナーの宛先を構成します。メッセージ宛先参照は、メッセージの宛先として機能する EJB モジュール内のエンタープライズ Bean を見つけるために使用する論理名です。メッセージ宛先参照は、以下に示すような、J2EE 1.4 およびそれ以降の成果物にのみ存在します。

J2EE 1.4 アプリケーション・クライアント
EJB 2.1 プロジェクト
2.4 Web アプリケーション

複数のメッセージ宛先参照が単一のメッセージ宛先リンクに関連付けられている場合、メッセージ宛先リンクにマップする (そしてその結果、リンク先のすべてのメッセージ宛先参照にマップする) エンタープライズ Bean を示す単一の JNDI 名がデプロイメントの際に収集されます。実行時に、メッセージ宛先参照はターゲットの稼働環境で管理対象のメッセージ宛先にバインドされます。メッセージ宛先参照およびメッセージ駆動型 Bean が同じメッセージ宛先によってリンクされている場合は、参照および Bean の両方に同じ宛先 JNDI 名がなければなりません。両方に同じ名前があるとき、メッセージ駆動型 Bean の宛先 JNDI 名のみが収集されて、対応するメッセージ宛先参照に適用されます。デプロイヤーがアプリケーションのインストール時にデフォルト・バインディングを生成することを選択した場合、インストール・ウィザードは JNDI 名を以下の不完全なメッセージ宛先参照に割り当てます。

メッセージ宛先参照に <message-destination-link> がある場合、 JNDI 名は ejs/message-destination-linkName に設定されます。そうでない場合は、JNDI 名が eis/message-destination-refName に設定されます。

この規則は、メッセージ駆動型 Bean の宛先 JNDI 名を検出します。ソース・スキャナーでクイック・フィックスが使用可能です。クイック・フィックスは、宛先 JNDI 名を weblogic-ejb-jar.xml ファイルから WebSphere(R) Application Server バインディング・ファイルにコピーします。ただしクイック・フィックスは、ActivationSpec の JNDI 名は設定しません。つまり、ejb-jar.xml 中のアクティベーション構成プロパティーをマイグレーションしません。

Liberty 用の手動での解決方法

Liberty へのマイグレーションにバインディングを定義する

メッセージ駆動型 Bean を Liberty にマイグレーションするときには、IBM MQ、JCA リソース・アダプター、および組み込みメッセージング・サーバーという 3 つの接続オプションが使用可能です。詳細については、これらのオプションについて詳しくは、資料を参照してください。

WebSphere traditional 用の手動での解決方法

アプリケーションの開発時にバインディングを定義する

アプリケーション開発者は、EJB 3.0 および Web 2.5 モジュールの ibm-xxx-bnd.xml ファイル、および Java(R) Platform の Enterprise Edition (Java EE) 5 より前に存在したモジュールの ibm-xxx-bnd.xmi ファイルに、バインディング定義を作成できます。アプリケーション開発者は、IBM(R) Rational(R) Developer ツールなどのツールを使用して、または EJB 3.0 や Web 2.5 モジュールでは XML エディターやテキスト・エディターを使用して、ファイルを作成できます。開発者はその後、バインディングが完了しているエンタープライズ・アプリケーション (.ear ファイル) を、アプリケーションのアセンブラーまたはデプロイヤーに付与します。アプリケーションをアセンブルするとき、アセンブラーはバインディングを変更しません。同じように、WebSphere Application Server でサポートされるサーバーにアプリケーションをインストールするとき、アプリケーションを正常にデプロイするためにバインディングを変更する必要がある場合を除いて、デプロイヤーはバインディングを変更またはオーバーライドしたりデフォルトのバインディングを生成したりしません。

アセンブリー・ツールの Rational Application Developer を開始します。
正しい EJB プロジェクトを開きます。
デプロイメント記述子をダブルクリックします。
正しいメッセージ駆動型 Bean をクリックします。
「WebSphere バインディング」セクションにスクロールダウンします。
「JCA アダプター」チェック・ボックスを選択して、ActivationSpec JNDI 名を入力します。

Rational Application Developer バージョン 7.0 は、EJB 2.0 Bean 用の EJB 2.1 活動化仕様の設定をサポートしていません。 EJB 2.1 活動化仕様は EJB 2.1 Bean 用にのみ設定できます。

アプリケーションを WebSphere Application Server にデプロイするとき、管理コンソールを使用して MDB 用に活動化仕様を設定します。
管理コンソールから、アプリケーション用の EAR ファイルをエクスポートします。
デプロイメント記述子を EAR ファイルからプロジェクトにコピーして、プロジェクトが正しい活動化仕様を持つようにします。

アプリケーションのアセンブル時にバインディングを定義する

アプリケーション・アセンブラーは、アプリケーションのアノテーションまたはデプロイメント記述子にバインディングを定義できます。 Java EE 5 モジュールは、ソース・コード内にアノテーションを含みます。アプリケーション・アセンブラーは、アノテーションを宣言するためにキーワードの先頭に @ 文字を付けます。 Java EE 5 より前のモジュールのバインディングは、デプロイメント記述子エディターの「WebSphere バインディング」セクションに指定されます。デプロイメント記述子を変更すると、アプリケーションの開発時に作成されるバインディング・ファイルでのバインディング定義が変更されることがあります。バインディングを定義した後に、アセンブラーはアプリケーションをデプロイヤーに提供します。 WebSphere Application Server でサポートされるサーバーにアプリケーションをインストールするとき、アプリケーションをデプロイするためにバインディングを変更する必要がある場合を除いて、デプロイヤーはバインディングを変更またはオーバーライドしたりデフォルトのバインディングを生成したりしません。

アプリケーションのインストール時にバインディングを定義する

アプリケーション・デプロイヤーまたはサーバー管理者は、管理コンソールを使用して WebSphere Application Server でサポートされるサーバー上にアプリケーションをインストールするときに、バインディングを変更できます。新しいバインディング定義をインストール・ウィザードのページに指定できます。

また、デプロイヤーまたは管理者は、アプリケーションのインストール時にデフォルト・バインディングを生成することを選択することもできます。アプリケーションのインストール時にデフォルト・バインディングを生成するように選択すると、製品はデフォルト値を使用してアプリケーション内でバインディングを完了するように指示を受けます。既存のバインディングは変更されません。

制限: アプリケーション・クライアントのアプリケーションをインストールする際には、バインディングを定義したりオーバーライドしたりできません。アプリケーション・クライアント・モジュールのバインディングはアセンブリー時に定義する必要があり、そのバインディングをバインディング・ファイルに保管する必要があります。

アプリケーション・インストールの構成時にバインディングを定義する

アプリケーションが WebSphere Application Server でサポートされるサーバーにインストールされた後、アプリケーション・デプロイヤーまたはサーバー管理者は、エンタープライズ・アプリケーション用の設定ページからアクセスされるものなど、管理コンソールのページの値を変更することによってバインディングを変更できます。