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

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

Edge 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 yang dapat digunakan oleh Proxy API lainnya.

Anti-pola

Memanggil satu Proxy API dari yang lain menggunakan HTTPTargetConnection di titik akhir 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>http://myorg-test.apigee.net/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('http://myorg-test.apigee.net/proxy2);
response.waitForComplete();

Alur Kode

Untuk memahami mengapa hal ini memiliki kerugian, kita perlu memahami rute suatu permintaan seperti yang digambarkan oleh diagram di bawah ini:

Gambar 1: Alur Kode

Seperti yang digambarkan dalam diagram, permintaan melintasi beberapa komponen yang terdistribusi, termasuk {i>Router<i} dan {i>Message Processor<i}.

Dalam contoh kode di atas, memanggil Proxy 2 dari Proxy 1 berarti permintaan harus dirutekan melalui rute tradisional (yaitu Router > MP) saat runtime. Fungsi ini sama seperti memanggil API dari klien sehingga membuat beberapa hop jaringan yang menambah latensi. Hop ini adalah tidak perlu mengingat permintaan {i>Proxy<i} 1 telah "mencapai" MP.

Dampak

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

Praktik terbaik

  • Menggunakan pembuatan perantaian proxy untuk memanggil satu Proxy API dari proxy lainnya. Perantaian {i>proxy<i} lebih efisien karena menggunakan koneksi lokal untuk mereferensikan titik akhir target (Proxy API lain).

    Contoh kode menampilkan perantaian proxy menggunakan LocalTargetConnection di endpoint Anda definisi:

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

    Proxy API yang dipanggil akan dieksekusi dalam Pemroses Pesan yang sama; maka, ia akan menghindari hop jaringan seperti yang ditampilkan dalam gambar berikut:

    Gambar 2: Alur Kode dengan Rantai Proxy

Bacaan lebih lanjut