Antipola: Memanggil proxy dalam proxy menggunakan kode kustom atau sebagai target

Anda sedang melihat dokumentasi Apigee dan Apigee hybrid.
Lihat dokumentasi Apigee Edge.

Apigee memungkinkan Anda memanggil satu proxy API dari proxy API lain. Fitur ini berguna terutama jika Anda memiliki proxy API yang berisi kode yang dapat digunakan kembali dan dapat digunakan oleh proxy API lainnya.

Antipola

Memanggil satu proxy API dari proxy lain menggunakan HTTPTargetConnection di endpoint target atau kode JavaScript kustom akan menghasilkan hop jaringan tambahan.

Memanggil proxy 2 dari proxy 1 menggunakan HTTPTargetConnection

Contoh kode berikut memanggil proxy 2 dari proxy 1 menggunakan HTTPTargetConnection:

<!-- /antipatterns/examples/2-1.xml -->
<HTTPTargetConnection>
  <URL>https://api-test.example.com/proxy2</URL>
</HTTPTargetConnection>

Memanggil proxy 2 dari proxy 1 dari kode JavaScript

Contoh kode berikutnya memanggil proxy 2 dari proxy 1 menggunakan JavaScript:

<!-- /antipatterns/examples/2-2.xml -->
var response = httpClient.send('https://api-test.example.com/proxy2);
response.waitForComplete();

Alur Kode

Untuk memahami mengapa hal ini memiliki kelemahan bawaan, kita perlu memahami rute yang diambil permintaan seperti yang diilustrasikan oleh diagram di bawah:

1) Klien membuat permintaan ke Proxy 1, 2) Permintaan dari Proxy 1 ke Proxy 2 menyebabkan hop jaringan, 3) Permintaan dari Proxy 2 ke target.
Gambar 1: Alur kode

Seperti yang digambarkan dalam diagram, permintaan melintasi beberapa komponen terdistribusi, termasuk Router dan Message Processor.

Dalam contoh kode di atas, memanggil proxy 2 dari proxy 1 berarti permintaan harus dirutekan melalui rute tradisional (Router > MP) saat runtime. Hal ini akan mirip dengan memanggil API dari klien sehingga membuat beberapa hop jaringan yang menambah latensi. Hop ini tidak diperlukan mengingat permintaan proxy 1 telah menjangkau MP.

Dampak

Memanggil satu proxy API dari proxy API lain akan menyebabkan hop jaringan yang tidak perlu, yaitu permintaan harus diteruskan dari satu Message Processor ke Message Processor lainnya.

Praktik terbaik

  • Gunakan fitur rantai proxy untuk memanggil satu Proxy API dari proxy lainnya. Rantai proxy lebih efisien karena menggunakan koneksi lokal untuk mereferensikan endpoint target (Proxy API lain).

    Contoh kode menunjukkan rantai proxy menggunakan LocalTargetConnection dalam definisi endpoint Anda:

    <!-- /antipatterns/examples/2-3.xml -->
<LocalTargetConnection>
  <APIProxy>proxy2</APIProxy>
  <ProxyEndpoint>default</ProxyEndpoint>
</LocalTargetConnection>

    Proxy API yang dipanggil akan dieksekusi dalam Message Processor yang sama; sehingga, proxy ini menghindari hop jaringan seperti yang ditunjukkan pada gambar berikut:

    1) Klien membuat permintaan ke Proxy 1, 2) Permintaan dari Proxy 1 ke Proxy 2 dibuat melalui panggilan pseudo-lokal, 3) Permintaan dari Proxy 2 ke target.
    Gambar 2: Alur kode dengan rantai proxy

Bacaan lebih lanjut