Memasukkan kode sesuai prosedur

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Anda dapat menambahkan kode dalam bahasa sesuai prosedur seperti JavaScript, Java, dan Python, lalu menggunakan ke kode tersebut dari bagian lain proxy API. Dukungan untuk kode sesuai prosedur dirancang untuk membuatnya memudahkan Anda dalam menerapkan penanganan variabel alur, kesalahan, serta permintaan dan respons yang kompleks tubuh.

Dengan kode sesuai prosedur, Anda dapat:

  • Membuat atau memanipulasi nilai tubuh yang kompleks, seperti nilai permintaan dan respons.
  • Menulis ulang URL, misalnya menyamarkan URL endpoint target.
  • Menambahkan logika lain yang tidak tersedia dengan kebijakan yang disertakan.

Cara kerjanya

Anda menggunakan kebijakan khusus untuk bahasa tersebut agar dapat melakukan panggilan dari alur proxy ke kode yang disertakan. Untuk setiap bahasa yang didukung, Apigee menyertakan kebijakan terpisah: Kebijakan JavaScript, kebijakan Java callout, dan kebijakan PythonScript.

Yang berikut ini menjelaskan, secara umum, salah satu cara kerjanya. Pastikan untuk melihat kebijakan referensi untuk informasi lebih detail.

  1. Di file terpisah, tulis kode yang akan Anda gunakan.
  2. Di kode Anda, masukkan hasil pemrosesan kode ke dalam variabel alur Apigee.

    Anda akan mengambil nilai variabel di tempat lain di proxy API. Untuk mengetahui informasi selengkapnya tentang alur variabel, lihat Mengelola status proxy dengan variabel flow.

  3. Tambahkan file (atau JAR) sebagai file resource ke proxy API Anda.

    Untuk mengetahui informasi selengkapnya tentang file resource, lihat File resource.

  4. Tambahkan kebijakan yang sesuai dengan bahasa yang Anda gunakan.

    Konfigurasikan kebijakan untuk melakukan panggilan ke kode dari tempat yang diinginkan di API Anda di alur proxy.

  5. Gunakan kebijakan untuk mengambil nilai kode dari variabel flow.

Batasan

Model keamanan Apigee tidak mengizinkan panggilan sistem seperti I/O jaringan, sistem file operasi baca/tulis, info pengguna saat ini, daftar proses, dan penggunaan CPU/memori. Meskipun ada beberapa mungkin berfungsi, tidak didukung, dan dapat dinonaktifkan secara aktif kapan saja. Sebagai kompatibilitas maju, Anda harus menghindari melakukan panggilan seperti itu dalam kode Anda.

Batasan lain mungkin berlaku untuk setiap bahasa yang didukung, seperti yang dijelaskan dalam referensi kebijakan yang terkait.

Bahasa yang didukung

JavaScript

Dukungan untuk JavaScript mencakup model objek lengkap untuk menangani variabel dan nilai tertentu ke proxy API. Untuk informasi selengkapnya, lihat model objek JavaScript.

Untuk informasi referensi kebijakan dan contohnya, baca artikel kebijakan JavaScript.

Java

Menggunakan Info Java kebijakan untuk melakukan panggilan ke kode Java dari alur proxy Anda. Topik referensi kebijakan mencakup contoh.

Python

Menggunakan Skrip Python policy untuk memanggil kode Python.