API Proxy 教戰手冊模式

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

本主題將討論 Apigee Edge 食譜範例中示範的部分 API Proxy 開發模式。隨著範例食譜的增加,我們也打算在這個主題中加入更多模式。

JavaScript HTTP 用戶端模式

JavaScript HTTP 用戶端模式是您可以用來使用 Apigee Edge 建立伺服器端 Mashup 的多種模式之一。Apigee 的 JavaScript 物件模型可讓您將 JavaScript 程式碼直接連接至 API Proxy 流程。物件模型的 httpClient 物件可讓您呼叫後端服務,並使用 JavaScript 擷取結果。

政策組合模式

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

政策組合模式的核心是 ServiceCallout 政策。ServiceCallout 政策會充當後端 API 或服務的 HTTP 用戶端。不過,為了讓 ServiceCallout 完全運作,您必須依賴其他政策,才能與遠端 API 或服務進行有意義的互動。其他政策則用於產生 ServiceCallout 傳送的要求訊息,並剖析遠端 API 或服務的回應訊息內容。

政策組合食譜範例使用了三個政策:AssignMessageServiceCalloutExtractVariables。這些政策會封裝您要傳送至後端的要求訊息、將訊息路由至後端的用戶端,以及用於剖析各個 API 回應並為回應資料指派變數的訊息剖析器。所有呼叫完成後,系統會合併收集到的變數,並以單一 JSON 物件傳回。

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

  • AssignMessage:建立要求訊息、填入 HTTP 標頭和查詢參數,並設定 HTTP 動詞。
  • ServiceCallout:參照由 AssignMessage 政策建立的訊息,定義外部呼叫的目標網址,並為目標服務傳回的回應物件定義名稱。
  • ExtractVariables:通常會定義 JSONPath 或 XPath 運算式,用於剖析先前 ServiceCallout 政策產生的訊息。接著,政策會設定包含從 ServiceCallout 回應解析的值的變數。

如需政策組合模式的完整示例,請參閱「使用政策組合」。