條件參考資料

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

條件可讓 API Proxy 在執行階段動態運作。條件會定義變數的運算，並由 Apigee Edge 處理管道評估。條件陳述式為布林值，一律會評估為 true 或 false。

條件總覽

本節說明如何以及在何處使用 Edge 的條件陳述式。此外，以下各節說明語法：

• 運算子
• 運算元
• 字面值

條件陳述式的結構

條件陳述式的基本結構如下：

<Condition>variable.name operator "value"</Condition>

例如：

<Condition>request.verb = "GET"</Condition>

您可以使用 AND 結合條件，一次強制執行多個條件。舉例來說，只有在要求的 URI 符合 /statuses 且要求的 HTTP 動詞是 GET 時，下列條件才會評估為 true：

<Condition>(proxy.pathsuffix MatchesPath "/statuses") and (request.verb = "GET")</Condition>

可使用條件陳述式的位置

您可以使用條件控管下列項目的行為：

• 政策執行
• 流程執行
• 選取目標端點路徑

政策執行

您可以使用條件陳述式控管政策的強制執行。常見用途是根據 HTTP 標頭或訊息內容，有條件地轉換回應訊息。

以下範例會根據 Accept 標頭，有條件地將 XML 轉換為 JSON：

<Step>
  <Condition>request.header.accept = "application/json"</Condition>
  <Name>XMLToJSON</Name>
</Step>

流程執行

您可以使用條件陳述式，控管 ProxyEndpoints 和 TargetEndpoints 中具名流程的執行作業。請注意，只有「具名」流程可以有條件地執行。ProxyEndpoint 和 TargetEndpoint 上的前置流程和後置流程 (要求和回應) 會針對每筆交易執行，因此提供無條件的「安全」功能。

舉例來說，如要根據要求訊息的 HTTP 動詞執行條件式要求流程，並根據代表錯誤的 (可能) HTTP 狀態碼執行條件式回應流程，請按照下列步驟操作：

<Flow name="GetRequests">
  <Condition>request.verb = "GET"</Condition>
  <Request>
    <Step>
      <Condition>request.path MatchesPath "/statuses/**"</Condition>
      <Name>StatusesRequestPolicy</Name>
    </Step>
  </Request>
  <Response>
    <Step>
      <Condition>(response.status.code = 503) or (response.status.code = 400)</Condition>
      <Name>MaintenancePolicy</Name>
    </Step>
  </Response>
</Flow>

選取目標端點路徑

使用條件陳述式，您可以控制 Proxy 端點設定所叫用的目標端點。路由規則會將要求轉送至特定目標端點。如果有多個可用目標端點，系統會評估路由規則的條件，如果條件為 true，要求就會轉送至具名的目標端點。

舉例來說，如要根據 Content-Type 將訊息有條件地轉送至指定目標端點，請執行下列步驟：

<RouteRule name="default">
 <!--this routing executes if the header indicates that this is an XML call. If true, the call is routed to the endpoint XMLTargetEndpoint-->
  <Condition>request.header.Content-Type = "text/xml"</Condition>
  <TargetEndpoint>XmlTargetEndpoint</TargetEndpoint>
</RouteRule>

詳情請參閱「流程變數和條件」。

路徑運算式

路徑運算式用於比對 URI 路徑，使用「*」代表單一路徑元素，使用「**」代表多個 URI 層級。

例如：

% 會被視為逸出字元。模式 %{user%} 與 {user} 相符，但與 user 不相符。

變數

您可以在條件陳述式中使用內建流程變數和自訂變數。 如需詳細資訊，請參閱：

• 流程變數參照：內建變數的完整清單
• ExtractVariables 政策：設定自訂變數的操作說明

運算子

使用運算子時，請遵守下列限制：

• 運算子不能做為變數名稱。
• 運算子前後必須有空格字元。
• 如要在變數中加入運算子，變數名稱必須以單引號括住。 例如 'request.header.help!me'。
• 系統不支援算術運算子 (+ * - / %)。
• 運算子會使用 Java 優先順序。
• Apigee Edge 依賴 java.util.regex 中實作的規則運算式。

下表列出支援的運算子。您可以在運算式中使用符號或字詞：

運算元

Apigee Edge 會先將運算元調整為通用資料型別，再進行比較。舉例來說，如果回應狀態碼為 404，則運算式 response.status.code = "400" 和 response.status.code = 400 等效。

如果是數值運算元，除非值以下列方式終止，否則資料類型會解讀為整數：

• 「f」或「F」(浮點數，例如 3.142f、91.1F)
• 「d」或「D」(雙精度，例如 3.142d、100.123D)
• 「l」或「L」(長整數，例如 12321421312L)

在這些情況下，系統會執行下表所示的調整 (其中 RHS 是指方程式的右側，LHS 是指左側)：

空值運算元

下表顯示當運算元左側 (LHS) 和/或右側 (RHS) 的值為空值時，條件會評估為 true 或 false：

常值

除了字串和數值常值，您還可以在條件陳述式中使用下列常值：

• null
• true
• false

例如：

• request.header.host is null
• flow.cachehit is true

範例

<RouteRule name="default">
     <Condition>request.header.content-type = "text/xml"</Condition>
     <TargetEndpoint>XmlTargetEndpoint</TargetEndpoint>
</RouteRule>

<Step>
    <Condition>response.status.code = 503</Condition>
    <Name>MaintenancePolicy</Name>
</Step>

<Flow name="GetRequests">
    <Condition>response.verb="GET"</Condition>
    <Request>
        <Step>
            <Condition>request.path ~ "/statuses/**"</Condition>
            <Name>StatusesRequestPolicy</Name>
        </Step>
    </Request>
    <Response>
        <Step>
            <Condition>(response.status.code = 503) or (response.status.code = 400)</Condition>
            <Name>MaintenancePolicy</Name>
        </Step>
    </Response>
</Flow>