Pattern del libro di istruzioni sul proxy per le API

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Questo argomento descrive alcuni dei pattern di sviluppo dei proxy API illustrati negli esempi del cookbook di Apigee Edge. Man mano che aggiungiamo altri esempi di cookbook, prevediamo di aggiungere altri pattern a questo argomento.

Il pattern del client HTTP JavaScript

Il pattern del client HTTP JavaScript è uno dei diversi pattern che puoi utilizzare per creare mashup lato server con Apigee Edge. Il modello a oggetti JavaScript di Apigee ti consente di collegare il codice JavaScript direttamente a un flusso di proxy API. L'oggetto httpClient del modello a oggetti ti consente di effettuare chiamate ai servizi di backend e recuperare i risultati utilizzando JavaScript.

Il pattern di composizione delle policy

La composizione delle policy è un pattern di proxy API Apigee che ti consente di combinare i risultati di più target di backend in un'unica risposta utilizzando le policy. In pratica, la composizione delle policy ti consente di creare mashup utilizzando le policy.

Al centro del pattern di composizione delle policy c'è la policy ServiceCallout. La policy ServiceCallout funge da client HTTP per l'API o il servizio di backend. Tuttavia, per essere completamente funzionale, un ServiceCallout si basa su altre policy per consentire un'interazione significativa con un'API o un servizio remoto. Altre policy vengono utilizzate per generare il messaggio di richiesta che viene inviato da ServiceCallout e per analizzare il contenuto nel messaggio di risposta dall'API remota o dal servizio.

L'esempio di cookbook sulla composizione delle policy utilizza tre policy: AssignMessage, ServiceCallout, e ExtractVariables. Queste policy incapsulano i messaggi di richiesta che vuoi inviare al backend, il client che instrada il messaggio al backend e un analizzatore di messaggi che analizza la risposta di ogni API e assegna le variabili ai dati di risposta. Una volta effettuate tutte le chiamate, le variabili raccolte vengono combinate e restituite in un singolo oggetto JSON.

Ecco un breve riepilogo di queste tre policy:

  • AssignMessage: crea un messaggio di richiesta, popola le intestazioni HTTP e parametri di query, imposta il verbo HTTP.
  • ServiceCallout: fa riferimento a un messaggio creato dalla policy AssignMessage definisce un URL di destinazione per la chiamata esterna e definisce un nome per l'oggetto di risposta restituito dal servizio di destinazione.
  • ExtractVariables: in genere definisce un'espressione JSONPath o XPath che analizza il messaggio generato dalla policy ServiceCallout precedente. La policy imposta quindi variabili contenenti i valori analizzati dalla risposta ServiceCallout.

Consulta Utilizzo della composizione delle policy per un esempio completo che illustra il pattern di composizione delle policy.