JavaScript 政策

重写目标网址

下面是一个常见的用例：从请求正文中提取数据，将其存储在流变量中，并在代理流的其他位置使用该流变量。假设您有一个应用，用户可以在 HTML 表单中输入其名称并提交该名称。您希望 API 代理提取表单数据，并将其动态添加到用于调用后端服务的网址。如何在 JavsScript 政策中执行此操作？

注意：如果您想试用此示例，我们假设您在代理编辑器中创建了一个新代理。创建代理时，您只需为其提供后端服务网址：http://www.example.com。在本示例中，我们将动态重写后端网址。如果您不知道如何创建新代理，请参阅使用入门教程。.

1. 在 Edge 界面中，打开您在代理编辑器中创建的代理。
2. 选择开发标签页。
3. 从“新建”菜单中，选择新建脚本。
4. 在对话框中，选择 JavaScript 并为脚本命名，例如 js-example。
5. 将以下代码粘贴到代码编辑器中，并保存代理。需要注意的是 context 对象。在代理流中的任何位置，您都可以在 JavaScript 代码中使用此对象。它用于获取流特定常量、调用有用的 get/set 方法以及执行更多操作。该对象部分属于 Edge 的 JavaScript 对象模型。另请注意，target.url 流变量是内置的读/写变量，可通过目标请求流访问。当我们通过 API 网址设置该变量时 对该网址进行后端调用。我们实质上重写了原始目标网址，也就是您在创建代理时指定的网址（例如，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。
7. 为政策命名，例如 target-rewrite。接受默认值并保存政策。
8. 如果您在导航工具中选择代理端点 Preflow，将看到该政策已添加到该流中。
9. 在导航工具中，选择目标端点 PreFlow 图标。
10. 在导航工具中，将 JavaScript 政策拖动到流编辑器中目标端点的请求端。
11. Save（保存）。
12. 调用如下所示的 API，根据需要替换正确的组织名称和代理名称：

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 推荐的最佳做法。