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 lainnya. 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 API 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>

Panggil 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 oleh permintaan seperti yang ditunjukkan oleh diagram di bawah ini:

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

Seperti yang ditunjukkan dalam diagram, permintaan melewati beberapa komponen terdistribusi, termasuk Router dan Pemroses Pesan.

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

Dampak

Memanggil satu proxy API dari proxy API lain akan menimbulkan hop jaringan yang tidak perlu, yaitu permintaan harus diteruskan dari satu Pemroses Pesan ke Pemroses Pesan lainnya.

Praktik terbaik

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

    Contoh kode menunjukkan perantaian 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 Pemroses Pesan yang sama. Dengan demikian, proxy tersebut akan menghindari hop jaringan seperti yang ditunjukkan dalam gambar berikut:

    1) Klien membuat permintaan ke Proxy 1, 2) Permintaan dari Proxy 1 ke Proxy 2 yang dilakukan melalui panggilan psuedo-local, 3) Permintaan dari Proxy 2 ke target.
    Gambar 2: Alur kode dengan perantaian proxy

Bacaan lebih lanjut