JavaScript 政策

重寫目標網址

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

注意：如要試用這個範例，我們假設您已在 Proxy 編輯器中建立新的 Proxy。建立時，只要提供下列後端服務網址即可： http://www.example.com。在本範例中，我們將動態重新編寫後端網址。 如要瞭解如何建立新的 Proxy，請參閱入門教學課程。。

1. 在 Edge UI 中，開啟您在 Proxy 編輯器中建立的 Proxy。
2. 選取「開發」分頁標籤。
3. 從「新增」選單中選取「新增指令碼」。
4. 在對話方塊中選取 JavaScript，然後為指令碼命名，例如 js-example。
5. 在程式碼編輯器中貼上下列程式碼，然後儲存 Proxy。請注意 context 物件。JavaScript 程式碼可在 Proxy 流程中的任何位置存取這個物件。可用於取得流程專屬常數、呼叫實用的 get/set 方法，以及執行更多作業。這個物件部分屬於 Edge 的 JavaScript 物件模型。請注意，target.url 流程變數是內建的讀取/寫入變數，可在目標請求流程中存取。當我們使用 API 網址設定該變數時，Edge 會對該網址發出後端呼叫。我們基本上已重新編寫原始目標網址，也就是您建立 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. 在 Navigator 中選取 Proxy Endpoint Preflow，您會看到該流程已新增政策。
9. 在 Navigator 中，選取「Target Endpoint PreFlow」圖示。
10. 在導覽器中，將 JavaScript 政策拖曳到流程編輯器中「目標端點」的「要求」側。
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 呼叫中可用的錯誤處理技術討論，請參閱 Apigee 社群中的這篇文章。Apigee 社群提供的建議僅供參考，不一定代表 Apigee 建議的最佳做法。