加入程序程式碼

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

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

透過程序程式碼,您可以:

  • 建立或操控複雜的主體值,例如要求和回應值。
  • 改寫網址,例如遮蓋目標端點網址。
  • 新增不包含政策無法使用的其他邏輯。

運作方式

您將使用語言專屬的政策,以便從 Proxy 流程呼叫包含的程式碼。Apigee Edge 針對每種支援的語言有單獨的政策:JavaScript 政策Java 呼叫政策Python 指令碼政策

以下概要說明這種運作原理。詳情請參閱政策參考資料。

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

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

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

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

  4. 根據你使用的語言添加相對應的政策。

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

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

限制

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

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

支援的語言

JavaScript

支援 JavaScript 包括完整的物件模型,用於處理 API Proxy 特有的變數和值。詳情請參閱「JavaScript 物件模型」。

如需政策參考資料資訊和範例,請參閱「JavaScript 政策」和「使用 JavaScript 編寫程式設計 API Proxy」。如需程式碼範例,請搜尋範例清單,找出含有 JavaScript 的範本。

Java

使用 Java 呼叫政策,透過 Proxy 流程呼叫 Java 程式碼。政策參考資料主題包含範例。

您可能也想瞭解以下主題:

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

Python

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

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