ベスト・プラクティス: メディエーション・モジュールおよびパッケージ化

メディエーション・サービス・アプリケーションを開発するときに、 JSP ファイル、JAR ファイル、Web プロジェクト、Java™ プロジェクト、 および J2EE プロジェクトなどのリソースを操作しなければならない場合があります。 このトピックでは、プロジェクトとリソースをセットアップして、これらを正常にビルドし、 WebSphere® Enterprise Server または WebSphere Process Server にデプロイできるようにするために役立つ情報を提供します。

Java コードでの作業

ベスト・プラクティス: カスタム・メディエーション・プリミティブによって使用される Java アプリケーションを開発したり、JAR ファイルをインポートしたりする必要がある場合は、 そのコードの Java プロジェクトを作成し、 その Java プロジェクト上の依存関係を、 Java コードを使用するメディエーション・モジュールに追加します。

ビジネス・インテグレーション・ライブラリーまたはメディエーション・モジュールの Java プロパティーは変更しないでください。 変更するとデプロイメント・コードの生成で問題が生じることがあります。 このため、使用を目的とした、複雑な Java アプリケーションの開発、 あるいはライブラリーまたはメディエーション・モジュールへの JAR ファイルのインポートはお勧めしません。また、メディエーション・モジュール・アセンブリー図で Java コンポーネントの Java 実装を生成するとき、 生成された Java 実装は、 他の Java クラスを呼び出すための起動点として使用する必要があります。

「ビジネス・インテグレーション」ビューには、アセンブリー図で使用される Java 実装とインターフェースのみが表示されることに注意してください。 これらの実装とインターフェースは、これらを使用するメディエーション・モジュールの下にリストされます。 Java プロジェクトを操作する必要がある場合、 「Java」™ パースペクティブでの作業に切り替えることができます。

「Java」パースペクティブへの切り替え

以下のステップに従って、「Java」パースペクティブを開きます。

  1. メニューから「ウィンドウ (Window)」 > 「パースペクティブを開く」 > 「その他...」を選択します。
  2. 「Java」を選択し、「OK」をクリックします。

「Java」パースペクティブで、ワークベンチ・ウィンドウの右上隅に 2 つの開いたパースペクティブが表示されます。 次のイメージにされている、「ビジネス・インテグレーション・パースペクティブ (Business Integration perspective)」ボタンをクリックすることにより、 「ビジネス・インテグレーション」パースペクティブに切り替えることができます。

ワークベンチ・ウィンドウの右上隅に表示されている 2 つのパースペクティブのボタン

Java プロジェクトにおける Java 開発のための説明を以下に示します。
  • Java プロジェクトを作成します。
  • Java プロジェクトで Java 開発を行います。 JAR ファイルをインポートする必要がある場合は、ファイルを Java プロジェクトにインポートします。 JAR ファイルをメディエーション・モジュールまたはライブラリーにはインポートしないでください。 JAR は EAR ファイルに追加されません
  • 依存関係エディターを使用して、Java コードを使用するメディエーション・モジュールを開きます。 従属プロジェクトとして Java プロジェクトを追加し、 「モジュールと共にデプロイ」チェック・ボックスが選択されていることを確認します。 依存関係エディターは Java プロジェクトをモジュールのクラスパスに追加します。 JAR ファイルはモジュールと共にデプロイされます。

インポートおよびエクスポート用のビジネス・オブジェクトおよびインターフェース

ベスト・プラクティス: メディエーション・モジュール・アセンブリー図でインポートおよびエクスポートを使用する場合は、 インポートおよびエクスポートによって使用されるビジネス・オブジェクトおよびインターフェースをライブラリーに登録して、 それらを共有できるようにするのが良い方法です。 次に、ライブラリーへの依存関係を、これらの共通リソースを使用するすべてのモジュールに追加します。 同じビジネス・オブジェクトとビジネス・インターフェースを異なるモジュールにコピーして使用することは避けてください。

共用されるライブラリー・リソース

デプロイメントの後で、 共用リソースがライブラリー内で変更された場合は、リソースを使用するモジュールを更新する必要があります。 例えば、2 つのモジュールがライブラリー内のいくつかのリソースを共用している場合に、 アプリケーションがデプロイされ、モジュールの 1 つを更新する必要があるとします。 更新した結果、ライブラリー内の共用リソースのいくつかが変更されます。 この場合、2 つ目のモジュールも更新して、共用リソース内の変更を反映する必要があります。

モジュールまたはライブラリーに置く必要がある WSDL ファイル

モジュールで WSDL ファイルを使用する必要がある場合は、 これをモジュールにコピーします。 オプションで、WSDL ファイルをライブラリーにコピーし、モジュール内において、 ライブラリーへの依存関係を設定します。これで、ライブラリーのリソースを使用できるようになります。 別のタイプのプロジェクト、例えば Web プロジェクトから WSDL ファイルをドラッグしようとすると、 モジュールまたはライブラリーに WSDL をコピーするように促すエラー・メッセージが表示されます。

J2EE モジュール名

メディエーション・モジュールは、 J2EE プロジェクトを構成する J2EE EAR ファイルを作成する単純なプロジェクトです。 モジュールの名前が MyApp の場合は、 以下の名前の J2EE プロジェクトが生成されます。 これらの名前は、独自の J2EE プロジェクトには使用しないでください。
  • MyAppApp
  • MyAppEJB
  • MyAppEJBClient
  • MyAppWeb

エディターを使用しない依存関係の変更

依存関係エディター以外でのモジュール依存関係の変更は避ける必要があります。

ライブラリー、Java プロジェクト、または J2EE プロジェクトへの依存関係を追加すると、 モジュールのプロパティーが変更されます。 モジュールのプロパティーは以下のように変更されます。

  • 「Java のビルド・パス」で、 ライブラリーまたはプロジェクトがビルド・パスに追加されます。
  • 「プロジェクト参照 (Project References)」で、 どの J2EE プロジェクトまたはユーティリティー JAR を、モジュール用の結果の EAR ファイルに含めるかが判別されます。 従属関係エディターで、ライブラリーまたはプロジェクトもモジュールと共にデプロイすることが選択されている場合、 選択されたライブラリーまたはプロジェクトが「プロジェクト参照 (Project References)」 に入力され、 デプロイメント用 EAR ファイルに追加されます。

メディエーション・モジュールおよびライブラリーのプロパティーを編集する代わりに、 依存関係エディターを使用してメディエーション・モジュールおよびライブラリーのプロジェクト依存関係を管理します。 メディエーション・モジュールおよびライブラリーのプロパティーには重要な Java 前提事項が設定されているため、Java プロパティーを変更すべきではありません。 例えば、ソース・フォルダーや出力フォルダーを変更しないでください。

関連概念
モジュールおよびライブラリー
モジュールとライブラリーの依存関係
ビジネス・インテグレーションのケイパビリティーおよびロール
ビジネス・インテグレーションの虎の巻
関連タスク
ビジネス・サービスに関するモジュールの作成
メディエーション・モジュールの作成
デフォルト名前空間の変更
ツール・ケイパビリティーを使用可能にする
モジュールおよびライブラリーへの依存関係の追加
ライブラリーの作成

関連情報

チュートリアル: モジュールおよびライブラリーの操作

Feedback
(C) Copyright IBM Corporation 2005, 2006. All Rights Reserved.
(C) Copyright IBM Japan 2006