変更の始まり

JavaCompute ノードを使用したグローバル・キャッシュへのアクセス

JavaCompute ノードを使用して、グローバル・キャッシュ内のマップと対話できます。

始める前に:
JavaCompute ノードを使用して、グローバル・マップにデータを保管できます。 その後、別の JavaCompute ノードを作成すると、このノードはグローバル・キャッシュからデータを取得でき、処理またはルーティングを行うことができます。 JavaCompute ノードは、MbGlobalMap オブジェクトを使用してグローバル・キャッシュにアクセスします。 このクラスを使用して、マップの取得と、マップ内のデータの書き込み/取得を行うことができます。 マップを明示的に作成することはできませんが、存在しないマップを取得する場合、マップは自動的に作成されます。

キャッシュとの対話はメッセージ・フロー・トランザクションの外部で発生し、直ちにコミットされます。 キャッシュと対話するノードの下流で例外がスローされた場合、キャッシュ対話はロールバックされません。

以下の手順は、あるメッセージ・フローがマップにデータを追加し、別のフローがそのマップからデータを取得する方法を説明しています。

  1. JavaCompute ノードを含むメッセージ・フローを作成します。

    JavaCompute ノードは、MQOutput ノードの前または後ろに配置できます。 次の例では、JavaCompute ノードは MQOutput ノードの後ろに配置されています。そのため、JavaCompute ノードは、出力メッセージのメッセージ ID を使用できます。

    このグラフィックは、MQOutput ノードに接続されている MQInput ノードを示しており、MQOutput ノードはさらに JavaCompute ノードに接続されています。

  2. JavaCompute ノードをダブルクリックします。 「新規 Java 計算ノード・クラス」ウィザードが開きます。
  3. 「Java 計算ノード・クラス」ペインで、該当する情報を指定してから「次へ」をクリックします。 デフォルト値のまま「次へ」をクリックしても構いません。
  4. 「Java 計算ノード・クラス・テンプレート」ペインで、最適なテンプレートを選択してから「完了」をクリックします。

    テンプレート Java ファイルがエディターで開かれます。ここで独自のコードを追加できます。

  5. マップを取得または作成 (まだ存在しない場合) するには、次の例で示すように、MbGlobalMap オブジェクトを追加します。 MbGlobalMap オブジェクトは、Java プラグイン API の資料でも説明されています。
    MbGlobalMap globalMap = MbGlobalMap.getGlobalMap("MyMap");
    この例では、「MyMap」というマップを取得します。マップがまだ存在しない場合、作成されます。 または、次の例で示すように、マップ名を指定せずにデフォルト・マップを使用することもできます。
    MbGlobalMap globalMap = MbGlobalMap.getGlobalMap();
    キャッシュは WebSphere eXtreme Scale 動的マップを使用します。 マップには任意の名前を指定できますが、SYSTEM.BROKER で始まる名前は使用できません。これはブローカーが使用するために予約されています。 デフォルト・マップの名前は SYSTEM.BROKER.DEFAULTMAP で、このマップを使用することも、消去することもできます。
  6. マップにデータを入力するには、次の例で示すように、マップ内にキーと値のペアを作成する必要があります。 キーと値には、Java プリミティブ・タイプおよびストリングを使用できます。
    globalMap.put(key, val);
  7. メッセージ・フローを保存します。
  8. 別のメッセージ・フローから保管データにアクセスするには、JavaCompute ノードが含まれるフローを作成します。

    例えば、次のメッセージ・フローには、マップから適切な情報を取得し、MQReply ノード経由で応答メッセージを送信する JavaCompute ノードが含まれています。

    このグラフィックは、JavaCompute ノードに接続されている MQInput ノードを示しており、JavaCompute ノードはさらに MQReply ノードに接続されています。

  9. 新規 JavaCompute ノード用の Java ファイルを作成するには、手順 2、3、および 4 を繰り返します。
  10. MbGlobalMap オブジェクトを使用して、手順 5 で作成したマップを取得してから、手順 6 でマップに追加したデータを取得します。 例えば、取得するデータがストリングであると判明している場合、次の例で示すように、データの取得時にストリングを指定します。
    MbGlobalMap globalMap = MbGlobalMap.getGlobalMap("MyMap");
    ...
    String val = (String)globalMap.get(key);

    キャッシュが大きくなりすぎるのを防ぐには、キーと値の組の作業が完了した後、remove() メソッドを使ってそのデータをマップから削除します。

    Java コードを構成する際、コンテンツ・アシストを使用して使用可能なオプションをリストすることができます。 コンテンツ・アシストにアクセスするには、挿入ポイントにカーソルを配置し、「編集」 > 「コンテンツ・アシスト」をクリックするか、Ctrl+Space を押します。例えば、「myMap」と入力して Ctrl+Space を押すと、次のアクションが含まれるオプションのリストから選択できます。
    • remove。グローバル・キャッシュから単一オブジェクトを削除します。
    • containsKey。マップにキーが存在するかどうかを示します。
    • update。既存のオブジェクトを更新します。
    すべての使用可能なオプションが、Java プラグイン API の Javadoc で説明されています (Message Broker Java API を参照してください)。Java プラグイン API の Javadoc には、「スタート」メニューで「スタート」 > 「プログラム」 > 「IBM WebSphere Message Broker 8.0.0.0」 > 「Java プログラミング API」 > 「Java プラグイン API 文書」 を選択してアクセスすることもできます。
  11. メッセージ・フローを保管します。
  12. メッセージ・フローをデプロイします。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:44:51


タスク・トピックタスク・トピック | バージョン 8.0.0.1 | bc23770_


変更の終わり