加入程序程式碼

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

您可以使用 JavaScript、Java 和 Python 等程序式語言新增程式碼，然後從 API Proxy 的其他部分呼叫該程式碼。我們支援的程序碼可讓您更輕鬆地實作流程變數、錯誤、要求和回應主體的複雜處理作業。

您可以使用程序碼執行下列操作：

• 建立或操作複雜的主體值，例如要求和回應值。
• 重寫網址，例如遮蔽目標端點網址。
• 新增其他邏輯，這些邏輯無法透過所包含的政策實現。

運作方式

您可以使用該語言專屬的政策，從 Proxy 流程呼叫至所包含的程式碼。針對每種支援的語言，Apigee 都會提供個別的政策：JavaScript 政策、JavaCallout 政策和 PythonScript 政策。

以下大致說明這項功能的運作方式。請務必參閱政策參考資料，瞭解詳情。

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

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

3. 將檔案 (或 JAR) 新增為 API 代理程式中的資源檔案。

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

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

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

5. 使用政策從資料流變數中擷取程式碼的值。

限制

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

每種支援語言可能會有其他限制，詳情請參閱該語言的對應政策參考資料。

支援的語言

JavaScript

JavaScript 支援功能包含完整的物件模型，可處理 API 代理程式專屬的變數和值。詳情請參閱「JavaScript 物件模型」。

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

Java

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

Python

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