API Proxy 教戰手冊模式

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

本主題探討 Apigee Edge 教戰手冊範例中呈現的一些 API Proxy 開發模式。隨著我們新增更多食譜集樣本，我們打算在這個主題中加入更多模式。

JavaScript HTTP 用戶端模式

JavaScript HTTP 用戶端模式是其中一種模式，可用於透過 Apigee Edge 建立伺服器端混搭。Apigee 的 JavaScript 物件模型可讓您將 JavaScript 程式碼直接接到 API Proxy 流程。物件模型的 httpClient 物件可讓您呼叫後端服務，並使用 JavaScript 擷取結果。

政策建立模式

政策組合是一種 Apigee API Proxy 模式，可讓您使用政策，將多個後端目標的結果合併為單一回應。事實上，政策組合可讓您使用政策建立混搭。

政策組合模式的核心是 ServiceCallout 政策。Service Call 政策可做為後端 API 或服務的 HTTP 用戶端。不過，為了確保功能可正常運作，Service callout 會仰賴其他政策，讓使用者與遠端 API 或服務進行有意義的互動。其他政策則的用途是產生服務呼叫所傳送的要求訊息，以及剖析遠端 API 或服務回應訊息中的內容。

政策組合教戰手冊範例使用三項政策：AssignMessage、ServiceCallout 和 ExtractVariables。這些政策會封裝您要傳送至後端的 request 訊息、將訊息轉送至後端的用戶端，以及剖析每個 API 回應並為回應資料指派變數的訊息剖析器。呼叫完所有呼叫後，系統會將收集到的變數合併，並傳回至單一 JSON 物件中。

以下簡要說明這三項政策：

  • AssignMessage：建立要求訊息、填入 HTTP 標頭和查詢參數，並設定 HTTP 動詞。
  • ServiceCallout：參照 AssignMessage 政策建立的訊息、定義外部呼叫的目標網址，並定義目標服務傳回的回應物件名稱。
  • ExtractVariables：通常定義 JSONPath 或 XPath 運算式，可剖析上述 Service callout 政策產生的訊息。政策接著會設定變數，其中包含從 Service 呼叫 回應剖析出的值。

如需政策組成模式的完整範例，請參閱「使用政策組合」一文。