JavaScript 政策

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

重寫目標網址

以下是常見用途：從要求主體中擷取資料，將資料儲存在流程變數中，然後在代理程式流程中的其他位置使用該流程變數。假設您有一個應用程式，使用者可在 HTML 表單中輸入名稱並提交。您希望 API Proxy 擷取表單資料，並動態將資料新增至用於呼叫後端服務的網址。您會如何在 JavsScript 政策中執行這項操作？

1. 在 Apigee UI 中，開啟在 Proxy 編輯器中建立的 Proxy。
2. 選取「開發」分頁標籤。
3. 在「新增」選單中，選取「新指令碼」。
4. 在對話方塊中選取 JavaScript，並為指令碼命名，例如 js-example。
5. 將下列程式碼貼到程式碼編輯器中，然後儲存 Proxy。請注意 context 物件。這個物件可供 Proxy 流程中的任何位置的 JavaScript 程式碼使用。這項元素用於取得特定流量的常數、呼叫實用的 get/set 方法，以及執行更多作業。這個物件部分屬於 Apigee 的 JavaScript 物件模型。請注意，target.url 流程變數是內建的讀/寫變數，可在目標要求流程中存取。當我們使用 API 網址設定該變數時，Apigee 會對該網址進行後端呼叫。我們基本上已重寫原始目標網址，也就是您建立 Proxy 時指定的網址 (例如http://www.example.com)。
   
   

   if (context.flow=="PROXY_REQ_FLOW") {
        var username = context.getVariable("request.formparam.user");
        context.setVariable("info.username", username);
   }
   
   
   if (context.flow=="TARGET_REQ_FLOW") {
        context.setVariable("request.verb", "GET");
        var name = context.getVariable("info.username");
        var url = "http://mocktarget.apigee.net/"
        context.setVariable("target.url", url + "?user=" + name);
   }
6. 在「新增政策」選單中，選取「JavaScript」JavaScript。
7. 為政策命名，例如 target-rewrite。接受預設值並儲存政策。
8. 如果在導覽器中選取 Proxy Endpoint Preflow，您會看到政策已新增至該流程。
9. 在導覽器中選取「Target Endpoint PreFlow」圖示。
10. 在導覽器中，將 JavaScript 政策拖曳至流程編輯器中目標端點的「Request」端。
11. 。
12. 請呼叫 API，並視需要替換正確的機構名稱和 Proxy 名稱：

curl -i -H 'Content-Type: application/x-www-form-urlencoded' -X POST -d 'user=Will' http://myorg-test.apigee.net/js-example

最後，我們來看看這個範例中所用 JavaScript 政策的 XML 定義。請注意，<ResourceURL> 元素用於指定要執行的 JavaScript 來源檔案。任何 JavaScript 來源檔案都會使用相同的模式：jsc://filename.js。如果 JavaScript 程式碼需要包含項目，您可以使用一或多個 <IncludeURL> 元素來執行這項操作，如本參考資料稍後所述。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="target-rewrite">
    <DisplayName>target-rewrite</DisplayName>
    <Properties/>
    <ResourceURL>jsc://js-example.js</ResourceURL>
</Javascript>

從 JavaScript 擷取屬性值

您可以在設定中新增 <Property> 元素，然後在執行階段使用 JavaScript 擷取元素的值。

使用元素的 name 屬性，指定從 JavaScript 程式碼存取屬性的名稱。<Property> 元素的值 (開頭和結尾標記之間的值) 是 JavaScript 會收到的字面值。

在 JavaScript 中，您可以將政策屬性值當作 Properties 物件的屬性存取，如以下所示：

• 設定資源。在這裡，屬性值是變數名稱 response.status.code。

  <Javascript async="false" continueOnError="false" enabled="true" timeLimit="200" name="JavascriptURLRewrite">
      <DisplayName>JavascriptURLRewrite</DisplayName>
      <Properties>
          <Property name="source">response.status.code</Property>
      </Properties>
      <ResourceURL>jsc://JavascriptURLRewrite.js</ResourceURL>
  </Javascript>

• 使用 JavaScript 擷取資源。在這裡，系統會使用 getVariable 函式擷取值 (變數名稱)，藉此擷取變數的值。

  var responseCode = properties.source; // Returns "response.status.code"
  var value = context.getVariable(responseCode); // Get the value of response.status.code
  context.setVariable("response.header.x-target-response-code", value);

處理錯誤

如需 JavaScript 呼叫中可用的錯誤處理技術範例和相關討論，請參閱「 從 JavaScript 政策傳回錯誤的正確方式」。Apigee 社群提供的建議僅供參考，不一定代表 Google 建議的最佳做法。