加入程序程式碼

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

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

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

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

運作方式

您可以使用該語言專屬的政策,從 Proxy 流程呼叫至所包含的程式碼。針對每種支援的語言,Apigee Edge 都包含一個獨立的政策:JavaScript 政策Java 呼叫出政策Python 指令碼政策

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

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

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

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

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

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

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

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

限制

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

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

支援的語言

JavaScript

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

如需政策參考資訊和範例,請參閱 JavaScript 政策使用 JavaScript 編寫 API 代理程式。如需程式碼範例,請搜尋範例清單,找出含有 JavaScript 的範例。

Java

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

您或許也會對以下主題感興趣:

如需程式碼範例,請搜尋範例清單,找出包含 Java 的範例。

Python

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

如需程式碼範例,請搜尋範例清單,找出包含 Python 的範例。