HTTPReply ノード

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

目的

応答をメッセージ・フローから Web サービス・クライアントに戻すには、HTTPReply ノードを使用します。 このノードは、HTTPInput ノードによって受信した入力メッセージを送信した Web サービス・クライアントへの応答を生成し、これが送信する確認を待機します。

メッセージ・フローに HTTPReply ノードを組み込む場合には、同じフローに HTTPInput ノードを組み込むか、HTTPInput ノードで始まる別のフローからメッセージを受信する必要があります。 応答は、HTTPInput ノードにより LocalEnvironment に保管される要求 ID によって、応答と関連付けられます。

このノードは、入力メッセージ・ツリー全体から Web サービス・クライアントの応答メッセージを構成し、それをリクエスターに戻します。

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

HTTPReply ノード・アイコン

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

このノードの使用例については、HTTPInput ノードを参照してください。

HTTPReply ノードの構成

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

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

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

  1. トランスポートに関連した障害を無視する場合 (例えば、クライアントが切断される場合)、「トランスポート障害を無視」チェック・ボックスを選択します。 このチェック・ボックスのチェックを外した場合、トランスポートに関連したエラーが発生すると、入力メッセージは failure ターミナルに伝搬されます。 チェック・ボックスのチェックを外す場合は、「送信タイムアウトに応答」に値を入力する必要があります。
  2. トランスポート障害を無視しない場合は、「送信タイムアウトに応答」に値を設定します。これは、クライアントが応答を受信したという確認通知を受け取るまでノードが待機する時間の長さです。 確認通知がこの時間内に受信されると、入力メッセージは、out ターミナル (接続されている場合) を経由して、メッセージ・フローの残りの部分に伝搬されます。 確認通知がこの時間内に受信されないと、入力メッセージは、failure ターミナル (接続されている場合) を経由して伝搬されます。failure ターミナルが接続されていない場合、確認通知が時間内に受信されないと、例外が生成されます。
  3. HTTPReplyHeader または HTTPResponseHeader からの値を使用してデフォルトの Web サービス・ヘッダーを作成したい場合は、「返信または応答からデフォルト HTTP ヘッダーを生成」チェック・ボックスを選択します。 入力メッセージに適切なヘッダーが存在しない場合は、デフォルト値が使用されます。

    ノードは、正しい計算値に設定された Content-Length ヘッダーを HTTPReplyHeader の中に必ず組み込みます。 このヘッダーが元の要求に組み込まれていない場合にもそうします。

  4. MRM パーサーの場合、メッセージ・セットから生成されたディクショナリーに対してメッセージ本体の妥当性検査を行いたいのであれば、プロパティー・ダイアログ・ナビゲーターの「妥当性検査」を選択します。 (メッセージがターミナルの failure ノードに伝搬される場合には、妥当性検査は行われません。)

    詳細については、メッセージの妥当性検査およびMRM ドメインのメッセージの妥当性検査プロパティーを参照してください。

  5. 簡略説明または詳細説明 (あるいはその両方) を入力するには、プロパティー・ダイアログ・ナビゲーターの「説明」を選択します。
  6. 「適用」をクリックすると、プロパティー・ダイアログを閉じずに HTTPReply ノードが変更されます。 「OK」をクリックすると、変更を適用してプロパティー・ダイアログを閉じます。

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

出力ターミナルを別のノードに接続する

メッセージをさらに処理したい場合、エラーを処理したい場合、あるいはメッセージを追加の宛先に送信したい場合は、このノードの out ターミナルまたは failure ターミナルをこのメッセージ・フローの別のノードに接続します。

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

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

ターミナル 説明
In ノードが処理するメッセージを受け入れる入力ターミナル。
Failure メッセージが伝搬される際に障害が検出された場合に、メッセージがルーティングされる出力ターミナル。
Out 正常に伝搬され、なおかつこのメッセージ・フロー内でさらに処理が必要な場合にメッセージがルーティングされる出力ターミナル。

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

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

プロパティー M C デフォルト 説明
トランスポート障害を無視 はい いいえ 選択されている トランスポートに関連した障害を無視するかどうか。 チェック・ボックスを選択すると、このアクションが実行されます。
送信タイムアウトに応答 はい いいえ 120 応答ノードが、応答がクライアントに到達しなかったと想定するまでに待機する時間 (秒単位)。 有効範囲は、0 (無期限待機を表す) から (231)-1 です。 「トランスポート障害を無視」がクリアされている場合に限り有効です。
返信または応答からデフォルト HTTP ヘッダーを生成 はい いいえ 選択されている HTTPReplyHeader または HTTPResponseHeader からの値を使用してデフォルトの Web サービス・ヘッダーを作成する場合に、このチェック・ボックスを選択します。

HTTPReply ノードの妥当性検査プロパティーについては、次の表に説明されています。

これらのプロパティーの詳細については、MRM ドメインのメッセージの妥当性検査プロパティーを参照してください。

プロパティー M C デフォルト 説明
妥当性検査 はい はい 継承 妥当性検査が行われるかどうか。有効な値は、「なし」「内容と値」「内容」、 および「継承」です。
失敗処置 はい いいえ 例外 妥当性検査に障害が発生した場合の動作。 「妥当性検査」を「内容」または「内容と値」に設定した場合にのみ、このプロパティーを設定できます。 有効な値は、「ユーザー・トレース」「ローカル・エラー・ログ」「例外」、および「例外リスト」です。
すべての値制約を含める はい いいえ 選択されている このプロパティーは編集できません。 チェック・ボックスが選択されていることにより示されるデフォルトのアクションは、基本値制約検査が「内容と値」妥当性検査に含まれるということです。
修正 はい いいえ 「なし」 このプロパティーは編集できません。

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

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