加入程序程式碼

本頁內容適用於 ApigeeApigee Hybrid

查看 Apigee Edge 說明文件。

您可以在程序語言 (例如 JavaScript、Java 和 Python) 中新增程式碼,然後從 API Proxy 的其他部分呼叫該程式碼。支援程序化程式碼的設計,是為了讓您更輕鬆地實作流程變數、錯誤,以及要求和回應主體的複雜處理作業。

使用程序碼,您可以:

  • 建立或操控複雜的主體值,例如要求和回應值。
  • 重新編寫網址,例如遮蓋目標端點網址。
  • 新增內含政策未提供的其他邏輯。

運作方式

您可以使用特定語言的政策,從 Proxy 流程呼叫納入的程式碼。Apigee 為每種支援的語言提供個別政策:JavaScript 政策JavaCallout 政策PythonScript 政策

以下大致說明其中一種運作方式。詳情請參閱政策參考資料。

  1. 在另一個檔案中,編寫要使用的程式碼。
  2. 在程式碼中,將程式碼處理結果放入 Apigee 流程變數。

    您會在 API Proxy 的其他位置擷取變數值。如要進一步瞭解流程變數,請參閱「使用流程變數管理 Proxy 狀態」。

  3. 將檔案 (或 JAR) 新增為 API Proxy 的資源檔案。

    如要進一步瞭解資源檔案,請參閱「資源檔案」。

  4. 新增所用語言對應的政策。

    設定政策,從 API Proxy 流程中的所需位置呼叫程式碼。

  5. 使用政策從流程變數擷取代碼的值。

限制

Apigee 安全性模型不允許系統呼叫,例如網路 I/O、檔案系統讀取/寫入、目前使用者資訊、程序清單和 CPU/記憶體使用率。雖然部分這類通話可能可以運作,但我們不支援這類通話,且隨時可能主動停用。為確保向前相容性,請避免在程式碼中進行這類呼叫。

如要瞭解各支援語言的其他限制,請參閱相應的政策參考資料。

支援的語言

JavaScript

JavaScript 支援包含完整的物件模型,可處理 API 代理專用的變數和值。詳情請參閱 JavaScript 物件模型

如需政策參考資訊和範例,請參閱 JavaScript 政策

Java

使用 JavaCallout 政策,從 Proxy 的流程呼叫 Java 程式碼。政策參考主題包含範例。

Python

使用 Python 指令碼政策呼叫 Python 程式碼。