HTTP メッセージ・フローを使用して Web サービスや RESTful サービスを含む HTTP アプリケーションと対話する場合には、この情報をお読みください。
この情報は、Web サービスのシナリオ セクションと共に読むと便利です。
HTTP 非同期要求/応答の使用
デフォルトで、すべての HTTPInput および HTTPReply ノードは、WebSphere® MQ キューを使用して HTTP ノードとのインターフェースを取るブローカー全体のリスナーを使用します。
1 つ以上の実行グループを構成して、その実行グループにデプロイしたすべての HTTPInput および HTTPReply が組み込みリスナーを使用するようにすることができます。
ProxyConnectHeaders は、HTTPS (SSL) 接続でのみ使用できます。 これらのヘッダーは、HTTP 接続では使用できません。
HTTP 非同期要求/応答の使用
HTTP 要求の送出と応答の受信を非同期に行うには、メッセージ・フローで HTTPAsyncRequest ノードと HTTPAsyncResponse ノードを使用します。
HTTPAsyncRequest ノードは、応答を待たずに次のメッセージを処理します。応答は、別のスレッドの新規トランザクションで HTTPAsyncResponse ノードが受け取ります。
したがって、より少ないスレッドを使用してより多くの要求を処理できます。
詳しくは、HTTP 非同期要求/応答の使用を参照してください。

例えば、(ブローカーによる既存の Web サービスの呼び出し に示されているように) 既存の WebSphere MQ アプリケーションと 対話するメッセージ・フローのペアを設計する場合、ID 値を要求フローに保管し、応答フローで復元することにより、その応答を適切なクライアントが受け取ることを保証できます。この手法を使用する場合、データを変更してはならず、データを BLOB として保存する必要があります。
HTTPReply ノードは、ローカル環境ツリーから ID 値を抽出し、特定のクライアントに送られるように、返信をセットアップします。しかし HTTPInput ノードのないフローで HTTPReply ノードを使用し、このフィールドが削除されたか、正しく設定されていない場合には、メッセージ BIP3143S が出されます。
HTTPInput ノードと HTTPReply ノードの両方が含まれているメッセージ・フローを設計する場合、 ID 値は HTTPInput ノードによってローカル環境内に設定されますが、HTTPReply ノードはそれを使用しません。 したがって、メッセージ・フローが同じフローに両方の HTTP ノードおよび Compute ノードを含んでいる場合、メッセージ・ツリーのどのコンポーネントが Compute ノード (「Compute モード」プロパティー) によって入力メッセージから出力メッセージにコピーされるかを指定するとき、ローカル環境ツリーを含む必要はありません。
または HTTPAsyncRequest
ノードでプロパティー「デフォルト Web サービス URL」を設定して、Web サービス要求用の宛先 URL を決定できます。値セットをプロパティーにオーバーライドするために、メッセージ・フロー内の HTTPRequest
またはHTTPAsyncRequest
ノードの前に、
Compute ノードを構成することができます。
LocalEnvironment.Destination.HTTP.RequestURL に URL ストリングを保管する ESQL をコーディングします。ノードは URL ストリングを検索して、ノード・プロパティー値の代わりに使用します。
Compute ノードにある要求メッセージ (他のすべての設定値をオーバーライドする) の HTTPRequestHeader ヘッダー・セクションにある特定のヘッダー X-Original-HTTP-URL で要求 URL も設定することができますが、柔軟性を高めるにはローカル環境ツリーの内容をこのために使用してください。
CALL CopyMessageHeaders();
SET OutputRoot.HTTPReplyHeader."Content-Type" = 'text/xml';
SET OutputRoot.XMLNS = InputRoot.XMLNS;
MIME ドメインで作業しているのでない限り、ContentType プロパティーを使用して Content-Type を設定しないでください。 ContentType プロパティーは、MIME 内で使用される Content-Type の値を設定することを意図しています。
HTTPReplyHeader ヘッダー・セクションが、HTTPReply ノードによって受け取られるメッセージ内に存在し、HTTPReply ノードの Output ターミナルが接続されている場合、HTTPReplyHeader ヘッダー・セクションはすべての変更された値または追加された値で更新されます。
または HTTPAsyncRequest
ノードのための「入力からデフォルト HTTP ヘッダーを生成」の設定
または HTTPAsyncRequest
ノードのプロパティーで「入力からデフォルト HTTP ヘッダーを生成」を選択する場合、ノードにはサーバーに送られる要求のヘッダーの最小セットが含まれています。CALL CopyMessageHeaders();
SET OutputRoot.HTTPRequestHeader."Content-Type" = 'text/xml';
SET OutputRoot.XMLNS = InputRoot.XMLNS;
MIME ドメインで作業しているのでない限り、ContentType プロパティーを使用して Content-Type を設定しないでください。
ContentType プロパティーは、MIME 内で使用される Content-Type の値を設定することを意図しています。
または HTTPAsyncRequest
ノードは、「入力または要求からデフォルト HTTP ヘッダーを生成」のチェックをクリアにした場合でも、常に Content-Length ヘッダーを再書き込みします。このアクションによって、内容が正しいことが確認されます。受け取ったメッセージに HTTPRequestHeader ヘッダーが存在する場合、HTTPRequestHeader ヘッダーはすべての変更された値または追加された値で更新されます。