Membentuk, mengakses, dan mengonversi pesan

Anda melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Anda dapat menggunakan kebijakan yang disertakan dengan Apigee Edge untuk memanipulasi pesan yang mengalir melalui proxy API Anda. Dengan kebijakan, Anda dapat:

  • Mengonversi pesan antarformat, seperti dari XML ke JSON.
  • Menetapkan nilai variabel dari konten pesan, dan membuat pesan dari nilai variabel.
  • Menggunakan kode prosedural, seperti JavaScript, Java, dan Python, untuk menangani pesan dan data dengan cara yang lebih kompleks.

Secara umum, saat menggunakan kebijakan ini, Anda menentukan input dan output sebagai variabel alur. Pada waktu proses, Apigee Edge mengambil nilai input dari variabel sumber dan menulis nilai output ke variabel output.

Topik ini memperkenalkan kemampuan tersebut. Untuk informasi teknis dan lebih lengkap, lihat referensi kebijakan untuk setiap kebijakan.

Penanganan sederhana untuk XML dan JSON

Apigee Edge menyertakan kebijakan yang memudahkan konversi antara XML dan JSON, serta untuk mengubah XML dengan XSL.

Mengonversi JSON ke XML

Kebijakan JSON ke XML mengambil input JSON Anda dan mengonversinya ke XML.

Dalam contoh kebijakan berikut, kebijakan mengambil pesan berformat JSON dari variabel request, lalu mengganti nilai variabel dengan pesan berformat XML. Input ditentukan dalam elemen <Source>, sedangkan output ditentukan dalam elemen <OutputVariable>.

<JSONToXML name="jsontoxml">
     <Source>request</Source>
     <OutputVariable>request</OutputVariable>
</JSONToXML>

Mengonversi XML ke JSON

Kebijakan XML ke JSON mengonversi pesan input XML menjadi JSON.

Dalam contoh kebijakan berikut, kebijakan mengambil pesan berformat XML dari variabel response, lalu mengganti nilai variabel dengan pesan berformat JSON. Input ditentukan dalam elemen <Source>, sedangkan output ditentukan dalam elemen <OutputVariable>.

<XMLToJSON name="ConvertToJSON">
   <OutputVariable>response</OutputVariable>
   <Source>response</Source>
</XMLToJSON>

Mengubah XML dengan XSL

Anda dapat menggunakan kebijakan Transformasi XSL untuk mengubah pesan menggunakan XSL. Misalnya, setelah mengonversi payload JSON ke XML, Anda dapat menggunakan kebijakan Transformasi XSL dengan lembar gaya untuk melakukan transformasi yang Anda butuhkan.

Dalam contoh kebijakan berikut, kebijakan mengambil pesan berformat XML dari variabel response, lalu mengganti nilai variabel dengan pesan yang diformat oleh my_transform.xsl. Input ditentukan dalam elemen <Source>, sedangkan output ditentukan dalam elemen <OutputVariable>.

<XSL name="TransformXML">
    <ResourceURL>xsl://my_transform.xsl</ResourceURL>
    <Source>response</Source>
    <OutputVariable>response</OutputVariable>
</XSL>

    <Source>request</Source>
    <ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
    <OutputVariable/>

Menangani data variabel

Penanganan data dalam proxy sering kali hanya melibatkan penggunaan data status sebagai nilai flow variable. Anda sering kali dapat melakukannya dengan menggunakan kebijakan yang mendapatkan atau menetapkan nilai variabel. Misalnya, Anda mungkin ingin membentuk nilai variabel menjadi pesan, atau mengekstrak konten pesan untuk menetapkan nilai variabel.

Pastikan untuk melihat referensi untuk dua kebijakan berikut:

Membuat transformasi yang lebih kompleks

Untuk penanganan data yang kompleksitasnya berada di luar kemampuan kebijakan yang disertakan, Anda dapat menggunakan bahasa prosedural seperti JavaScript, Java, atau Python.

Umumnya, hal ini melibatkan penulisan kode dalam salah satu bahasa ini, lalu memanggil kode dari kebijakan yang khusus untuk bahasa tersebut. Untuk mengetahui informasi selengkapnya, lihat Menggabungkan kode prosedural kode.