WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

環境ツリーへのアクセス

environment ツリーには独自の相関名 Environment があり、このツリーの内容を参照または設定するすべての ESQL ステートメントで、この名前を使用する必要があります。

論理ツリーが入力メッセージ用に作成される際に、environment ツリーが必ず作成されます。 しかし、メッセージ・フローは、そこにデータを取り込んだり、その内容を使用したりすることはありません。 このツリーは、あるノードから別のノードへと情報を受け渡すなどの、独自の目的に使用できます。 このツリー全体をスクラッチパッドまたは作業域として使用できます。

environment に独自のデータを作成する利点は、メッセージ・フロー内の後続のノードに、このデータが論理ツリーの一部として伝搬されることです。 Compute ノードに新規出力メッセージを作成する場合には、 environment ツリーも入力メッセージからその新規出力メッセージにコピーされます。 (これはローカル環境ツリーとは対照的です。ローカル環境ツリーは明示的に要求した場合にのみ出力メッセージに組み込まれます。)

メッセージ・フローの存続期間中、environment ツリーは 1 つだけ存在します。 あるノードで更新または追加したデータは保存され、メッセージ・フロー内のすべてのノードはこのツリーの最新のコピーにアクセスします。 メッセージ・フローがそのメッセージ・フローに戻る場合でも (例えば、例外がスローされる場合、 またはメッセージが FlowOrder ノードの第 2 のターミナルを経由して処理される場合)、最新の状態が保存されます。 (これは、ローカル環境ツリーとは対照的です。ローカル環境ツリーは、メッセージがメッセージ・フローをたどって戻った場合に前の状態に復帰します。)

このツリーは、選択する任意の目的に使用できます。例えば、次の ESQL ステートメントを使用してツリー内にフィールドを作成できます。
SET Environment.Variables = 
      ROW('granary' AS bread, 'reisling' AS wine, 'stilton' AS cheese);
SET Environment.Variables.Colors[] = 
      LIST{'yellow', 'green', 'blue', 'red', 'black'};
SET Environment.Variables.Country[] = LIST{ROW('UK' AS name, 'pound' AS currency),
   	 ROW('USA' AS name, 'dollar' AS currency)};

この情報は、メッセージ・フローにおける相対位置にかかわらず、メッセージの伝搬先のすべてのノードで有効です。

environment を使用してメッセージ・フロー内の他のノードが用いる情報を保管する方法の別の例は、以下のサンプル中の Reservation メッセージ・フローを参照してください。 メッセージ・フローの Compute ノードは、 入力メッセージのフィールドの値に応じてデータベースから抽出されたサブツリー Environment.Variable に情報を書き込みます。

サンプルに関する情報は、WebSphere® Message Broker Toolkit に統合されているインフォメーション・センター、またはオンライン・インフォメーション・センターを使用する場合にのみ表示できます。 サンプルは、WebSphere Message Broker Toolkit に統合されているインフォメーション・センターを使用する場合にのみ実行できます。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:45:34


タスク・トピックタスク・トピック | バージョン 8.0.0.5 | ac16840_