Anti-pattern: richiamare un proxy all'interno di un proxy utilizzando un codice personalizzato o come destinazione

Stai visualizzando la documentazione di Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.

Apigee consente di richiamare un proxy API da un altro proxy API. Questa funzionalità è utile soprattutto se hai un proxy API che contiene codice riutilizzabile che può essere utilizzato da altri proxy API.

Antipattern

La chiamata di un proxy API da un altro utilizzando HTTPTargetConnection nell'endpoint di destinazione o il codice JavaScript personalizzato determina un ulteriore hop di rete.

Richiama il proxy 2 dal proxy 1 utilizzando HTTPTargetConnection

Il seguente esempio di codice richiama il proxy 2 dal proxy 1 utilizzando HTTPTargetConnection:

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

Richiama il proxy 2 dal proxy 1 dal codice JavaScript

Il successivo esempio di codice richiama il proxy 2 dal proxy 1 utilizzando JavaScript:

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

Flusso codice

Per capire perché questo presenta uno svantaggio intrinseco, dobbiamo capire il percorso seguito da una richiesta, come illustrato dal diagramma seguente:

1) Il client invia una richiesta al Proxy 1, 2) La richiesta dal proxy 1 al proxy 2 comporta un hop di rete, 3) una richiesta dal proxy 2 alla destinazione.
Figura 1: flusso di codice

Come illustrato nel diagramma, una richiesta attraversa più componenti distribuiti, inclusi il router e il processore di messaggi.

Negli esempi di codice precedenti, la chiamata del proxy 2 dal proxy 1 significa che la richiesta deve essere instradata tramite la route tradizionale (Router > MP) in fase di runtime. Sarebbe come richiamare un'API da un client, creando così più hop di rete che aumentano la latenza. Questi hop non sono necessari poiché la richiesta proxy 1 ha già raggiunto l'MP.

Impatto

La chiamata di un proxy API da un altro proxy API comporta hop di rete non necessari, ovvero la richiesta deve essere trasmessa da un processore di messaggi a un altro.

Best practice

  • Utilizza la funzionalità di concatenamento dei proxy per richiamare un proxy API da un altro. Il concatenamento dei proxy è più efficiente poiché utilizza la connessione locale per fare riferimento all'endpoint di destinazione (un altro proxy API).

    L'esempio di codice mostra il concatenamento di proxy utilizzando LocalTargetConnection nella definizione dell'endpoint:

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

    Il proxy API richiamato viene eseguito all'interno dello stesso processore di messaggi; di conseguenza, evita l'hop di rete, come mostrato nella figura seguente:

    1) Il client invia una richiesta al Proxy 1, 2) Richiesta dal Proxy 1 al Proxy 2 effettuata tramite una chiamata locale, 3) Richiesta dal Proxy 2 al target.
    Figura 2: flusso di codice con concatenamento di proxy

Per approfondire