Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Puoi utilizzare i criteri inclusi in Apigee Edge per manipolare i messaggi che passano attraverso i proxy API. Con i criteri, puoi:
- Converti i messaggi tra formati, ad esempio da XML a JSON.
- Imposta i valori delle variabili dai contenuti dei messaggi e crea i messaggi dai valori delle variabili.
- Utilizza codice procedurale, come JavaScript, Java e Python, per gestire messaggi e dati in modi più complessi.
In generale, quando utilizzi questi criteri, specifichi l'input e l'output come variabili di flusso. In fase di esecuzione, Apigee Edge recupera il valore di input da una variabile di origine e scrive il valore di output in una variabile di output.
Questo argomento illustra queste funzionalità. Per informazioni più complete e tecniche, consulta i riferimenti alle norme di ciascun programma.
Gestione semplice per XML e JSON
Apigee Edge include criteri che semplificano la conversione tra XML e JSON e la trasformazione di XML con XSL.
Conversione di JSON in XML
Il criterio JSON to XML prende l'input JSON e lo converte in XML.
Nel seguente esempio di criterio, il criterio prende un messaggio in formato JSON dalla variabile request, quindi 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 di XML in JSON
Il criterio XML to JSON converte il messaggio di input XML in JSON.
Nel seguente esempio di criterio, il criterio prende un messaggio in formato XML dalla variabile response, quindi sostituisce il valore della variabile con un messaggio in formato JSON.
L'input è specificato nell'elemento <Source>, mentre l'output è specificato
nell'elemento <OutputVariable>.
<XMLToJSON name="ConvertToJSON"> <OutputVariable>response</OutputVariable> <Source>response</Source> </XMLToJSON>
Trasformazione di XML con XSL
Puoi utilizzare il criterio di trasformazione XSL per trasformare i messaggi utilizzando XSL. Ad esempio, dopo aver convertito un payload JSON in XML, puoi utilizzare il criterio di trasformazione XSL con un foglio di stile per eseguire la trasformazione necessaria.
Nel seguente esempio di criterio, il criterio prende un messaggio in formato XML dalla variabile response, quindi sostituisce il valore della variabile con un messaggio formattato da my_transform.xsl. L'input viene specificato nell'elemento <Source>, mentre l'output viene 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 variabili
La gestione dei dati all'interno di un proxy spesso comporta semplicemente il semplice lavoro con i dati di stato come valori delle variabili di flusso. Spesso è possibile farlo utilizzando un criterio che ottiene o imposta valori variabili. Ad esempio, potresti voler dare forma ai valori delle variabili in un messaggio o estrarre i contenuti di un messaggio per impostare i valori delle variabili.
Assicurati di consultare i riferimenti alle due norme seguenti:
- Assegna il criterio Message per creare messaggi dai valori delle variabili.
- Criterio Estrazione variabili per assegnare le variabili dai contenuti dei messaggi.
Creazione di trasformazioni più complesse
Per la gestione dei dati la cui complessità supera le capacità 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 e di richiamare il codice da un criterio specifico per quel linguaggio. Per saperne di più, consulta la sezione Incorporare il codice procedurale.