配置流

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

流是构成 API 代理的基础组件通过流,您可以配置 API 代理执行政策和代码的顺序,从而对 API 的行为进行编程。

如需从概念上大致了解流,请参阅控制如何使用流执行代理

本主题介绍如何创建条件流以及向更高级别的流添加逻辑(政策)。对创建条件的描述比本主题中介绍的内容更为详细。如需了解详情,请参阅流变量概览使用流变量的条件

向流附加政策

Edge 提供多种不同类型的预定义政策, 以及操纵消息。此外,您还可以通过这些政策添加自己的自定义代码来完全自定义消息处理。

例如:

  • OAuth 安全性政策附加到 ProxyEndpoint 的请求 PreFlow。由于 ProxyEndpoint 的请求 PreFlow 是流水线中的第一个流,因此您可以立即拒绝违反您的安全政策的请求。
  • JSON 到 XML 转换政策附加到 TargetEndpoint 的 响应 PostFlow,以便将响应从 JSON 转换为 XML。
  • JavaScript 政策附加到 ProxyEndpoint 的条件流,以便执行 JavaScript 代码来处理请求

创建条件流后,便可以附加到政策。选择流后,点击请求或响应图表中的 + 步骤图标,以向流添加新政策或现有政策。

在“导航器”菜单中突出显示了名为 issue 的条件流示例,在“流”窗格中显示了“步骤”按钮。

在“添加步骤”窗格中,创建了新的政策实例,其政策类型为“配额”且显示名称为 Quota-2。

通过将政策附加到选定的流,您正在配置 API 代理,以便仅对发送到该流 URI 和动词组合的请求强制执行配额政策。例如,如果您将政策附加到 learn 流,则在代理编辑器的代码视图中会生成以下 XML:

<ProxyEndpoint name="default">
...
   <Flow name="issue">
        <Description/>
        <Request>
            <Step>
                <Name>Quota-2</Name>
            </Step>
        </Request>
        <Response/>
        <Condition>(proxy.pathsuffix MatchesPath "/issue/**") and (request.verb = "GET")</Condition>
    </Flow>
... 
</ProxyEndpoint>

在此配置中,如果包含 URI 的 API 代理收到 GET 请求, .../issue/** 格式(将 /issue/ 替换为 URI 中最后一个倒序之后的任何内容 正斜线),则系统会对该 API 调用强制执行配额。

条件流简介

始终执行附加到 PreFlow 或 PostFlow 的所有政策。但是,仅当流的条件评估结果为 true 时,条件流中的政策才会执行。

在处理请求和响应的过程中,每个细分只执行一个条件流,即条件计算结果为 true 的第一个流。这意味着,您可以作为下列每项的一部分执行一个条件流:

  • ProxyEndpoint 的请求流水线
  • TargetEndpoint 的请求流水线
  • ProxyEndpoint 的响应流水线
  • TargetEndpoint 的响应流水线

视频:观看一段短视频,详细了解条件流。

例如,以下 ProxyEndpoint 定义显示了由 ProxyEndpoint 针对向 API 代理发出的任何 HTTP GET 请求执行的条件流:

<ProxyEndpoint name="default">
  <PreFlow>
    <Request/>
    <Response/>
  </PreFlow>   
  <Flows>
    <Flow name="Flow-1">
      <Condition>request.verb="GET"</Condition>
      <Request/>
      <Response/>
    </Flow>
  </Flows>
  <PostFlow>
    <Request/>
    <Response/>
  </PostFlow>
  ...
</ProxyEndpoint>

请注意,该条件引用 request.verb 流变量。流变量以引用的形式命名,用于保存关联的状态信息 使用 Edge 处理的 API 事务。Edge 定义了许多状态变量, 参考。

RESTful 服务是 API 资源的集合。API 资源是一种 URI 路径片段,用于识别开发者可通过调用 API 访问的某个实体。例如,如果您的服务后端提供天气报告和天气预报,则您的 API 可能会定义两个条件流以映射到这些 API 资源:/reports/forecasts。当 API 调用在网址中包含其中某个资源时,条件计算结果为 true,并执行与条件流关联的逻辑。

应用开发者随后可以通过向以下形式的网址发出请求来访问您的资源:

http://myAPIs.myCo.com/weather/reports

或者:

http://myAPIs.myCo.com/weather/forecasts

在 API 代理中,您可以定义与特定资源对应的条件流:

<ProxyEndpoint name="default">
  <PreFlow>
    <Request/>
    <Response/>
  </PreFlow>   
  <Flows>
    <Flow name="Flow-1">
      <Condition>(proxy.pathsuffix MatchesPath "/reports")</Condition>
      <Request/>
      <Response/>
    </Flow>
    <Flow name="Flow-2">
      <Condition>(proxy.pathsuffix MatchesPath "/forecasts")</Condition>
      <Request/>
      <Response/>
    </Flow>
  </Flows>
  <PostFlow>
    <Request/>
    <Response/>
  </PostFlow>
  ...
</ProxyEndpoint>

在此示例中,您可以引用 proxy.pathsuffix 流变量,其中包含用于访问 API 代理的网址的后缀部分。然后,您可以将不同的政策附加到每个资源的条件流中。

添加条件流

在这个简单的示例中,您将设置一个仅当请求消息为 HTTP GET 时才会执行的流。

如需添加条件流,请选择 API 代理构建器中的开发标签页。

代理构建器的“开发”标签页

点击所需端点中的 + 图标。

“添加条件流”按钮

通过新建条件流表单,您可以为流命名并配置条件。在以下示例中,您将添加一个简单的条件,用来评估任何 URI 上位于基本路径之后的 GET 动词(与 PUTPOST 等相反)的请求消息 HTTP。

在“新建条件流”窗格中,流名为 Flow-1,并且会配置条件类型、路径和动词。

(了解如何在流变量和条件中构建条件语句。)

名为Flow-1 的新流程现在显示在导航器菜单中。

突出显示了 Flow-1

现在观察 ProxyEndpoint 的 XML 配置。选择导航器菜单中的 Flow-1

您会看到以下配置。

<PreFlow name="PreFlow">
    <Request/>
    <Response/>
</PreFlow>   
<Flows>
    <Flow name="Flow-1">
      <Request/>
      <Response/>
      <Condition>(proxy.pathsuffix MatchesPath "/**") and (request.verb = "GET")</Condition>
    </Flow>
</Flows>
<PostFlow name="PostFlow">
    <Request/>
    <Response/>
</PostFlow>

后续步骤

以下主题详细介绍了如何构建条件和使用变量: