Incorporamento del codice procedurale

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Puoi aggiungere codice in linguaggi procedurali come JavaScript, Java e Python, quindi richiamare tale codice da altre parti di un proxy API. Il supporto per il codice procedurale è progettato per semplificare l'implementazione della gestione complessa di variabili di flusso, errori e corpi di richiesta e risposta.

Con il codice procedurale puoi:

  • Crea o manipola valori corporei complessi, ad esempio valori di richieste e risposte.
  • Riscrivi gli URL, ad esempio per mascherare un URL dell'endpoint di destinazione.
  • Aggiungi un'altra logica non disponibile con i criteri inclusi.

Come funziona

Puoi utilizzare un criterio specifico per la lingua per effettuare chiamate da un flusso proxy al codice incluso. Per ciascuno dei linguaggi supportati, Apigee Edge include un criterio separato: criterio JavaScript, criterio callout Java e Criterio Python Script.

Di seguito viene descritto, a livello generale, un modo in cui funziona. Assicurati di consultare i riferimenti alle norme per ulteriori dettagli.

  1. In un file separato, scrivi il codice che intendi utilizzare.
  2. Nel codice, inserisci il risultato dell'elaborazione del codice in una variabile di flusso Apigee Edge.

    Potrai recuperare il valore della variabile altrove nel proxy API. Per ulteriori informazioni sulle variabili di flusso, consulta Gestione dello stato del proxy con le variabili di flusso.

  3. Aggiungi il tuo file (o JAR) come file di risorsa al proxy API.

    Per ulteriori informazioni sui file delle risorse, consulta File di risorse.

  4. Aggiungi il criterio corrispondente alla lingua che stai utilizzando.

    Configura il criterio per effettuare una chiamata al tuo codice dalla posizione desiderata nel flusso del proxy API.

  5. Utilizza un criterio per recuperare il valore del codice dalla variabile di flusso.

Limitazioni

Il modello di sicurezza di Apigee Edge non consente chiamate di sistema quali I/O di rete, lettura/scrittura di file system, informazioni utente attuali, elenco di processi e utilizzo di CPU/memoria. Sebbene alcune di queste chiamate possano funzionare, non sono supportate e potrebbero essere attivamente disattivate in qualsiasi momento. Per la compatibilità con le deviazioni, dovresti evitare di effettuare chiamate di questo tipo nel tuo codice.

Potrebbero esistere altre limitazioni per ogni lingua supportata, come descritto nel riferimento alle norme corrispondente della lingua.

Lingue supportate

JavaScript

Il supporto per JavaScript include un modello a oggetti completo per la gestione di variabili e valori specifici di un proxy API. Per ulteriori informazioni, consulta la sezione Modello a oggetti JavaScript.

Per informazioni ed esempi di riferimento sui criteri, consulta le pagine Criteri JavaScript e proxy API di programmazione con JavaScript. Per il codice di esempio, cerca in Elenco di esempi quelli in cui è incluso JavaScript.

Java

Utilizza i criteri relativi ai callout Java per effettuare chiamate al codice Java dal flusso del proxy. L'argomento del riferimento alle norme include esempi.

Ti potrebbero interessare anche i seguenti argomenti:

Per il codice di esempio, cerca nell'Elenco esempi quelli che includono Java.

Python

Utilizza il criterio Python Script per richiamare il codice Python.

Per il codice di esempio, cerca nell'Elenco esempi quelli che includono Python.