Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Il criterio JavaScript in Apigee Edge ti consente di aggiungere codice personalizzato da eseguire nel contesto di un flusso proxy API. Ad esempio, il codice personalizzato nella norma JavaScript può essere utilizzato per:
- Ottieni e imposta variabili di flusso
- Esegui logica personalizzata e gestione degli errori
- Estrarre i dati da richieste o risposte
- Modifica in modo dinamico l'URL di destinazione del backend
- Aggiungere o rimuovere intestazioni in modo dinamico da una richiesta o una risposta
- Analizza una risposta JSON
Client HTTP
Una potente funzionalità del criterio JavaScript è il client HTTP. È possibile utilizzare il client HTTP (o l'oggetto httpClient) per effettuare una o più chiamate al backend o a servizi esterni. Il client HTTP è particolarmente utile quando è necessario effettuare chiamate a più servizi esterni e combinare le risposte in un'unica API.
Codice JavaScript di esempio che effettua una chiamata al backend con l'oggetto httpClient
var headers = {'X-SOME-HEADER' : 'some value' };
var myRequest = new Request("http://www.example.com","GET",headers);
var exchange = httpClient.send(myRequest);
L'oggetto httpClient espone due metodi get e send (utilizzato send nel codice campione precedente) per effettuare richieste HTTP. Entrambi i metodi sono asincroni e restituiscono un oggetto exchange prima del completamento della richiesta HTTP effettiva.
Le richieste HTTP potrebbero richiedere da alcuni secondi ad alcuni minuti. Una volta effettuata una richiesta HTTP, è importante sapere quando è stata completata, in modo che la risposta alla richiesta possa essere elaborata. Uno dei modi più comuni per determinare quando la richiesta HTTP è stata completata è richiamare il metodo waitForComplete() dell'oggetto exchange.
waitForComplete()
Il metodo waitForComplete() mette in pausa il thread finché la richiesta HTTP non viene completata e viene restituita una risposta (riuscito/errore). Quindi è possibile elaborare la risposta da un servizio di backend o esterno.
Esempio di codice JavaScript con waitForComplete()
var headers = {'X-SOME-HEADER' : 'some value' };
var myRequest = new Request("http://www.example.com","GET",headers);
var exchange = httpClient.send(myRequest);
// Wait for the asynchronous GET request to finish
exchange.waitForComplete();
// Get and Process the response
if (exchange.isSuccess()) {
var responseObj = exchange.getResponse().content.asJSON;
return responseObj.access_token;
} else if (exchange.isError()) {
throw new Error(exchange.getError());
}
Antipattern
L'utilizzo di waitForComplete() dopo l'invio di una richiesta HTTP nel codice JavaScript avrà implicazioni sulle prestazioni.
Considera il seguente codice JavaScript che chiama waitForComplete() dopo l'invio di una richiesta HTTP.
Codice per sample.js
// Send the HTTP request
var exchangeObj = httpClient.get("http://example.com");
// Wait until the request is completed
exchangeObj.waitForComplete();
// Check if the request was successful
if (exchangeObj.isSuccess()) {
response = exchangeObj.getResponse();
context.setVariable('example.status', response1.status);
} else {
error = exchangeObj.getError();
context.setVariable('example.error', 'Woops: ' + error);
}
In questo esempio:
- Il codice JavaScript invia una richiesta HTTP a un'API backend.
- Quindi chiama
waitForComplete()per mettere in pausa l'esecuzione fino al completamento della richiesta.L'API
waitForComplete()causa il blocco del thread che esegue il codice JavaScript finché il backend non completa l'elaborazione della richiesta e risponde.
Esiste un limite massimo per il numero di thread (30%) che possono eseguire contemporaneamente codice JavaScript in un Message Processor in qualsiasi momento. Una volta raggiunto questo limite, non saranno disponibili thread per eseguire il codice JavaScript. Pertanto, se ci sono troppe richieste concorrenti che eseguono l'API waitForComplete() nel codice JavaScript, le richieste successive non andranno a buon fine con un errore interno del server 500 e un messaggio di errore "Timeout" anche prima del timeout del criterio JavaScript.
In generale, questo scenario può verificarsi se il backend impiega molto tempo per elaborare le richieste o se il traffico è elevato.
Impatto
- Le richieste API non andranno a buon fine con 500 Internal Server Error e con il messaggio di errore "Timeout" quando il numero di richieste concorrenti che eseguono
waitForComplete()nel codice JavaScript supera il limite predefinito. - La diagnosi della causa del problema può essere complessa perché JavaScript non funziona e restituisce "Timeout" anche se il limite di tempo per il criterio JavaScript specifico non è trascorso.
Best practice
Utilizza i callback nel client HTTP per semplificare il codice callout, migliorare il rendimento ed evitare di utilizzare waitForComplete() nel codice JavaScript. Questo metodo garantisce che il thread che esegue JavaScript non venga bloccato fino al completamento della richiesta HTTP.
Quando si utilizza un callback, il thread invia le richieste HTTP nel codice JavaScript e torna al pool. Poiché il thread non è più bloccato, è disponibile per gestire altre richieste. Quando la richiesta HTTP è stata completata e il callback è pronto per essere eseguito, viene creata un'attività che viene aggiunta alla coda di attività. Uno dei thread del pool eseguirà il callback in base alla priorità dell'attività.
Esempio di codice JavaScript con callback in httpClient
function onComplete(response,error) {
// Check if the HTTP request was successful
if (response) {
context.setVariable('example.status', response.status);
} else {
context.setVariable('example.error', 'Woops: ' + error);
}
}
// Specify the callback Function as an argument
httpClient.get("http://example.com", onComplete);