概述

開發過程中：主要用于描述集成流和集成接口之間的綁定關系，如下圖所示。集成流和集成接口之間的關系，請參見集成流與集成接口的關系說明。

運行時：主要負責路由和入參校驗，將校驗通過的請求轉換成相應的消息格式并向后續節點傳遞。

路由和入參校驗

引擎在運行時會根據請求的HTTP Request Method和HTTP Requst URL進行匹配，查找對應的元數據進行動態處理。

同時，引擎還會根據集成接口定義的入參，對HTTP請求內容進行校驗，只有滿足條件的請求才能響應執行。如果校驗失敗，會直接返回錯誤。

• 一次請求中同時出現多個校驗失敗錯誤時，只會選擇報出其中一個錯誤信息。

• 錯誤碼信息如下：

示例如下：

節點輸出消息

輸出消息的Payload為HttpRequest類型，關于HttpRequest類型說明，請參見HttpRequest。

本文以獲取調用集成接口的入參內容為例說明，具體如下。

• 集成接口的定義如下，并完成與集成流的綁定。

• 集成流中，將請求參數q1保存到消息的變量字段中，設置變量的節點配置如下：

• 對應的腳本內容如下，可獲取到了接口的入參q1的值。

package bwiflu6pwj543473k0;

import com.alibaba.bwif.script.core.StepMessage
import com.alibaba.bwif.script.core.BwifHandler
import com.alibaba.bwif.script.core.protocol.http.HttpRequest
import com.alibaba.bwif.script.core.Entity

class SimpleHandler implements BwifHandler {
    @Override
    Object handle(StepMessage message) {
        HttpRequest req = message.getPayload()
        String q1 = req.getQueryParam("q1")
        return q1
    }
}

概述

您可以在本節點中定義調用集成接口獲得的HTTP Response的內容。

節點配置

主要的節點配置信息為HTTP響應信息（Response），相關配置項詳細說明如下：

使用示例

動態生成Entity對象，作為HTTP Response body的內容。具體示例請參見快速入門HTTP API Reply。

默認Response結構

引擎默認對返回的HTTP Response結構有統一約定，具體如下：

• Body部分。由開發者指定，通過HTTP API Reply節點中配置而來。

• Header部分。引擎默認會增加如下信息，用于方便排查問題。