Referensi kondisi

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

Kondisi memungkinkan proxy API berperilaku secara dinamis saat runtime. Kondisi menentukan operasi pada variabel, yang dievaluasi oleh pipeline pemrosesan Apigee. Pernyataan kondisional adalah boolean dan selalu bernilai true atau false.

Ringkasan kondisi

Bagian ini menjelaskan cara dan tempat menggunakan pernyataan kondisional dengan Apigee. Selain itu, bagian berikut menjelaskan sintaksis:

Struktur pernyataan bersyarat

Struktur dasar pernyataan kondisional adalah:

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

Contoh:

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

Anda dapat menggabungkan kondisi dengan AND untuk menerapkan lebih dari satu kondisi sekaligus. Misalnya, kondisi berikut dievaluasi menjadi true hanya jika URI permintaan cocok dengan /statuses dan kata kerja HTTP permintaan adalah GET:

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

Tempat Anda dapat menggunakan pernyataan bersyarat

Anda dapat menggunakan kondisi untuk mengontrol perilaku dalam hal berikut:

Eksekusi kebijakan

Dengan menggunakan pernyataan bersyarat, Anda dapat mengontrol penerapan kebijakan. Kasus penggunaan umum adalah transformasi bersyarat pesan respons, berdasarkan header HTTP atau konten pesan.

Contoh berikut secara kondisional mengubah XML menjadi JSON berdasarkan header Accept:

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

Eksekusi alur

Dengan menggunakan pernyataan kondisional, Anda dapat mengontrol eksekusi alur bernama di ProxyEndpoints dan TargetEndpoints. Perhatikan bahwa hanya alur bernama yang dapat dieksekusi secara bersyarat. Pra-alur dan pasca-alur (baik permintaan maupun respons) di ProxyEndpoints dan TargetEndpoints dijalankan untuk setiap transaksi, sehingga memberikan kemampuan failsafe tanpa syarat.

Misalnya, untuk menjalankan alur permintaan kondisional berdasarkan kata kerja HTTP dari pesan permintaan, dan alur respons kondisional berdasarkan kode status HTTP (potensial) yang mewakili error:

<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>

Pemilihan rute endpoint target

Dengan menggunakan pernyataan kondisional, Anda dapat mengontrol endpoint target yang dipanggil oleh konfigurasi endpoint proxy. Aturan rute meneruskan permintaan ke endpoint target tertentu. Jika lebih dari satu endpoint target tersedia, aturan rute dievaluasi untuk kondisinya dan, jika benar, permintaan akan diteruskan ke endpoint target yang disebutkan.

Misalnya, untuk merutekan pesan secara kondisional ke endpoint target yang ditetapkan berdasarkan 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>

Lihat Variabel dan ketentuan alur untuk mengetahui informasi selengkapnya.

Ekspresi jalur

Ekspresi jalur digunakan untuk mencocokkan jalur URI, menggunakan * untuk merepresentasikan satu elemen jalur dan ** untuk merepresentasikan beberapa tingkat URI.

Contoh:

Pola Contoh jalur URI yang cocok
/*/a/ /x/a/ atau /y/a/
/*/a/* /x/a/b atau /y/a/foo
/*/a/** /x/a/b/c/d
/*/a/*/feed/ /x/a/b/feed/ atau /y/a/foo/feed/
/a/**/feed/** /a/b/feed/rss/1234

% diperlakukan sebagai karakter escape. Pola %{user%} cocok dengan {user}, tetapi tidak cocok dengan user.

Variabel

Anda dapat menggunakan variabel alur bawaan dan variabel kustom dalam pernyataan kondisional. Untuk informasi selengkapnya, lihat:

Operator

Saat menggunakan operator, perhatikan batasan berikut:

  • Operator tidak dapat digunakan sebagai nama variabel.
  • Karakter spasi diperlukan sebelum dan sesudah operator.
  • Untuk menyertakan operator dalam variabel, nama variabel harus diapit tanda petik tunggal. Misalnya, 'request.header.help!me'.
  • Operator aritmetika (+ * - / %) tidak didukung.
  • Prioritas Java digunakan untuk operator.
  • Apigee mengandalkan ekspresi reguler seperti yang diterapkan di java.util.regex.

Tabel berikut mencantumkan operator yang didukung. Anda dapat menggunakan simbol atau kata dalam ekspresi:

Simbol Word Deskripsi
! Not, not Operator uner (mengambil satu input)
= Equals, Is Sama dengan (peka huruf besar/kecil)
!= NotEquals, IsNot Tidak sama dengan (peka huruf besar/kecil)
:= EqualsCaseInsensitive Sama dengan, tetapi tidak peka huruf besar/kecil
> atau &gt; GreaterThan Lebih besar dari. Jika Anda menggunakan > saat menentukan kondisi di UI Apigee, kondisi tersebut akan dikonversi menjadi &gt;.
>= atau &gt;= GreaterThanOrEquals Lebih dari atau sama dengan. Jika Anda menggunakan >= saat menentukan kondisi di UI Apigee, kondisi tersebut akan dikonversi menjadi &gt;=.
&lt; LesserThan Kurang dari. UI Apigee tidak mendukung literal <.
&lt;= LesserThanOrEquals Kurang dari atau sama dengan. UI Apigee tidak mendukung literal <=.
&& And, and Dan
|| Or Operator Atau tidak peka huruf besar/kecil. Misalnya, OR, Or, dan or semuanya valid.
() Mengelompokkan ekspresi. ( membuka ekspresi dan ) menutupnya.
~~ JavaRegex

Cocok dengan ekspresi reguler yang mematuhi javax.util.regex. Pencocokan bersifat peka huruf besar/kecil. Untuk contoh, lihat Pencocokan pola.
~ Matches, Like Mencocokkan pola gaya glob menggunakan karakter pengganti *. Pencocokan bersifat peka huruf besar/kecil. Untuk contoh, lihat Pencocokan pola.
~/ MatchesPath, LikePath Cocok dengan ekspresi jalur. Pencocokan peka huruf besar/kecil. Untuk contoh, lihat Pencocokan pola.
=| StartsWith Mencocokkan karakter pertama string. Pencocokan peka huruf besar/kecil.

Operand

Apigee menyesuaikan operand ke jenis data umum sebelum membandingkannya. Misalnya, jika kode status respons adalah 404, ekspresi response.status.code = "400" dan response.status.code = 400 setara.

Untuk operand numerik, jenis data ditafsirkan sebagai bilangan bulat kecuali jika nilai diakhiri sebagai berikut:

  • f atau F (float, misalnya, 3.142f, 91.1F)
  • d atau D (double, misalnya, 3.142d, 100.123D)
  • l atau L (long, misalnya, 12321421312L)

Dalam hal ini, sistem melakukan adaptasi yang ditunjukkan dalam tabel berikut (dengan RHS mengacu ke sisi kanan persamaan dan LHS adalah sisi kiri):

RHS LHS Boolean Bilangan bulat Long Float Ganda String Comparable Objek
Boolean Boolean Bilangan bulat Long Float Ganda String -
Bilangan bulat Bilangan bulat Bilangan bulat Long Float Ganda String Comparable -
Long Long Long Long Float Ganda String Comparable -
Float Float Float Float Float Ganda String Comparable -
Ganda Ganda Ganda Ganda Ganda Ganda String Comparable -
String String String String String String String Comparable -
Comparable Comparable Comparable Comparable Comparable Comparable Comparable Comparable -
Objek - - - - - - - -

Operand null

Tabel berikut menunjukkan apakah kondisi dievaluasi menjadi true atau false saat nilai null di sisi kiri (LHS) dan/atau sisi kanan (RHS) dari operand yang ditampilkan:

Operator LHS null RHS null LHS dan RHS null
=, ==, := false false true
=| false false false
!= true true false
> atau &gt; true false false
>= atau &gt;= false true true
&lt; true false false
&lt;= true false true
~ false T/A false
~~ false T/A false
!~ true false false
~/ false T/A false

Literal

Selain literal string dan numerik, Anda dapat menggunakan literal berikut dalam pernyataan kondisional:

  • null
  • true
  • false

Contoh:

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

Contoh

<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>