AggregateRequest ノード

このトピックには、以下のセクションが含まれています。

目的

AggregateRequest ノードは、要求メッセージが送信されたという事実を記録するために使用します。 このノードは、AggregateReply ノードが複合メッセージを構成するための情報も収集します。

集約は、要求/応答アプリケーション・モデルを拡張したものです。集約は、いくつもの関連した要求の生成およびファンアウトと、それに対応する応答のファンインを結合し、それらの応答をコンパイルして、単一の集約された応答メッセージを作成します。

集約関数は以下の 3 つのノードにより提供されます。

  1. AggregateControl ノードは、集約の一部である要求のファンアウトの始まりをマークします。 このノードは AggregateReply ノードが複数の要求のマッチングを行うために使用する制御メッセージを送信します。 制御ターミナルから伝搬される情報には、ブローカー ID、集約名プロパティー、およびタイムアウト・プロパティーが含まれます。 メッセージ環境に AggregateControl ノードによって追加された集約情報は、変更できません。
  2. AggregateRequest ノードは、要求メッセージが送信されたという事実を記録します。このノードは、AggregateReply ノードが集約された応答メッセージを構成するための情報も収集します。 メッセージ環境に AggregateRequest によって追加された情報は保存する必要があり、そうしないと集約は失敗します。
  3. AggregateReply ノードは、集約のファンインの終わりをマークします。このノードは、応答を収集して結合し、単独の集約された応答メッセージにします。

ワークベンチでは、AggregateRequest ノードは次のアイコンで表されます。

AggregateRequest ノード・アイコン

メッセージ・フロー内でのこのノードの使用

このノードが使用される方法に関しては、次のサンプルを参照してください。

AggregateRequest ノードの構成

AggregateRequest ノードのインスタンスをメッセージ・フローに入れると、AggregateRequest ノードを構成することができます。 エディター・ビューでノードを右クリックし、「プロパティー」をクリックします。ノードの基本プロパティーが表示されます。

値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。

以下のように、AggregateRequest ノードを構成します。

  1. フォルダー名」の値を入力します。 この名前が、この要求に対する応答を保管する AggregateReply ノードの複合メッセージ内のフォルダー名として使われます。このプロパティーは必須項目です。値を入力してください。 値は固有でなくてかまいません。
  2. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明」を選択します。
  3. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに AggregateRequest ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。

    「キャンセル」をクリックすると、ダイアログを閉じてプロパティーに対して行った変更をすべて破棄します。

ターミナルおよびプロパティー

AggregateRequest ノード・ターミナルについては、次の表に説明されています。

ターミナル 説明
In 集約要求の一部として送信されたメッセージを受け入れる入力ターミナル。
Out 処理が正常に終了した時に入力メッセージがルーティングされる出力ターミナル。

以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。

AggregateRequest ノードの「基本」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
フォルダー名 はい いいえ   AggregateReply ノードの複合メッセージ内のフォルダーとして使われる名前。 このプロパティーは必須です。

AggregateRequest ノードの「説明」プロパティーについては、次の表に説明されています。

プロパティー M C デフォルト 説明
簡略説明 いいえ いいえ   ノードの簡単な説明
詳細説明 いいえ いいえ   メッセージ・フロー内のノードの目的を説明するテキスト
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
ac04760_