Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Puoi utilizzare i criteri inclusi in Apigee Edge per manipolare i messaggi che passano attraverso i proxy API. Con i criteri puoi:
- Convertire i messaggi tra formati, ad esempio da XML a JSON.
- Imposta i valori delle variabili dai contenuti dei messaggi e crea i messaggi a partire 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 ai criteri per ciascuno.
Gestione semplificata di XML e JSON
Apigee Edge include criteri che semplificano la conversione da XML a JSON e la trasformazione di XML con XSL.
Conversione di JSON in XML
Il criterio da JSON a XML acquisisce il tuo input JSON e lo converte in XML.
Nel seguente esempio di criterio, il criterio acquisisce un messaggio in formato JSON dalla variabile request e ne sostituisce il valore con un messaggio in formato XML.
L'input è specificato nell'elemento <Source>, mentre l'output è specificato
nell'elemento <OutputVariable>.
<JSONToXML name="jsontoxml">
<Source>request</Source>
<OutputVariable>request</OutputVariable>
</JSONToXML>
Conversione da XML in JSON in corso...
Il criterio da XML a JSON converte il messaggio di input XML in JSON.
Nel seguente esempio di criterio, il criterio acquisisce un messaggio in formato XML dalla variabile response e ne sostituisce il valore 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 del file XML con XSL
Puoi utilizzare il criterio XSL per la trasformazione per trasformare i messaggi utilizzando XSL. Ad esempio, dopo aver convertito un payload JSON in XML, puoi utilizzare il criterio XSL Transform con un foglio di stile per eseguire la trasformazione necessaria.
Nel seguente esempio di criterio, il criterio acquisisce un messaggio in formato XML dalla variabile response e ne sostituisce il valore con un messaggio nel formato 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 delle variabili
La gestione dei dati all'interno di un proxy spesso comporta il semplice utilizzo dei dati di stato come valori di variabili di flusso. Spesso è possibile farlo utilizzando un criterio che recupera o imposta valori variabili. Ad esempio, potresti voler modellare i valori delle variabili in un messaggio o estrarre i contenuti di un messaggio per impostarli.
Assicurati di consultare i riferimenti alle due norme seguenti:
- Assegna criteri relativi ai messaggi per creare messaggi da valori variabili.
- Estrai criterio variabili per assegnare variabili dai contenuti dei messaggi.
Creare trasformazioni più complesse
Per la gestione di dati la cui complessità non rientra nelle capacità dei criteri inclusi, puoi utilizzare linguaggi procedurali come JavaScript, Java o Python.
In genere, ciò comporta la scrittura di codice in uno di questi linguaggi e poi la chiamata al codice da un criterio specifico per la lingua. Per ulteriori informazioni, consulta Incorporare il codice procedurale.