Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Puoi utilizzare i criteri inclusi in Apigee Edge per manipolare i messaggi che passano attraverso Proxy API. Con i criteri puoi:
- Converti i messaggi in diversi formati, ad esempio da XML a JSON.
- Imposta valori variabili dai contenuti dei messaggi e crea messaggi da valori variabili.
- Utilizza codice procedurale, come JavaScript, Java e Python, per gestire messaggi e dati in in modi più complessi.
In generale, quando utilizzi questi criteri, specifichi l'input e l'output come variabili di flusso. Alle ore di esecuzione, Apigee Edge recupera il valore di input da una variabile di origine e scrive l'output in una variabile di output.
Questo argomento illustra queste funzionalità. Per informazioni più complete e tecniche, consulta riferimenti alle norme per ciascuno.
Gestione semplice per XML e JSON
Apigee Edge include criteri che semplificano la conversione tra XML e JSON e trasformare il codice XML con XSL.
Conversione da JSON in XML in corso...
Le norme da JSON a XML prende il tuo input JSON e lo converte in XML.
Nel seguente esempio di criterio, il criterio accetta un messaggio in formato JSON dal
request, poi sostituisce il valore della variabile con un messaggio in formato XML.
L'input viene specificato nell'elemento <Source>, mentre l'output viene specificato
nell'elemento <OutputVariable>.
<JSONToXML name="jsontoxml">
<Source>request</Source>
<OutputVariable>request</OutputVariable>
</JSONToXML>Conversione da XML in JSON in corso...
Le norme da XML a JSON converte il messaggio di input XML in JSON.
Nel seguente esempio di criterio, il criterio accetta un messaggio in formato XML dalla
response, sostituisce il valore della variabile con un messaggio in formato JSON.
L'input viene specificato nell'elemento <Source>, mentre l'output viene specificato
nell'elemento <OutputVariable>.
<XMLToJSON name="ConvertToJSON"> <OutputVariable>response</OutputVariable> <Source>response</Source> </XMLToJSON>
Trasformazione di XML con XSL
Puoi utilizzare il formato XSL Criterio di trasformazione per trasformare i messaggi utilizzando XSL. Ad esempio, dopo la conversione di un file JSON il payload in XML, è possibile utilizzare il criterio XSL Transform con un foglio di stile per eseguire la trasformazione di cui hai bisogno.
Nel seguente esempio di criterio, il criterio accetta un messaggio in formato XML dalla
response, poi sostituisce il valore della variabile con un messaggio formattato in base a
my_transform.xsl. L'input è specificato nell'elemento <Source>,
mentre l'output è specificato nell'elemento <OutputVariable>.
<XSL name="TransformXML">
<ResourceURL>xsl://my_transform.xsl</ResourceURL>
<Source>response</Source>
<OutputVariable>response</OutputVariable>
</XSL>
<Source>request</Source>
<ResourceURL>xsl://XSL-Transform-1.xsl</ResourceURL>
<OutputVariable/>Gestione dei dati sulle variabili
La gestione dei dati all'interno di un proxy spesso comporta semplicemente il lavoro con dati di stato come variabili di flusso e i relativi valori. Spesso è possibile farlo utilizzando un criterio che ottiene o imposta valori variabili. Ad esempio: potresti voler trasformare i valori delle variabili in un messaggio o estrarre i contenuti di un messaggio imposta i valori delle variabili.
Assicurati di consultare i riferimenti alle due norme seguenti:
- Assegna messaggio per creare messaggi da valori variabili.
- Estrai variabili per assegnare variabili dai contenuti dei messaggi.
Creazione di trasformazioni più complesse
Per la gestione di dati la cui complessità non rientra nelle funzionalità dei criteri inclusi, puoi utilizzare linguaggi procedurali come JavaScript, Java o Python.
In genere, si tratta di scrivere il codice in uno di questi linguaggi, per poi richiamare il codice da un specifiche per la lingua. Per ulteriori informazioni, consulta la sezione Incorporazione procedurale Google Cloud.