Dar forma, acceder y convertir mensajes

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Puedes usar las políticas incluidas en Apigee para manipular los mensajes que fluyen a través de tus proxies de API. Con las políticas, puedes hacer lo siguiente:

  • Convertir mensajes entre formatos, como de XML a JSON.
  • Definir valores de variables a partir del contenido de los mensajes y crear mensajes a partir de valores de variables.
  • Usa código de procedimiento, como JavaScript, Java y Python, para gestionar mensajes y datos de formas más complejas.

Por lo general, cuando se usan estas políticas, se especifica la entrada y la salida como variables de flujo. En tiempo de ejecución, Apigee obtiene el valor de entrada de una variable de origen y escribe el valor de salida en una variable de salida.

En este tema se presentan estas funciones. Para obtener información más completa y técnica, consulta las referencias de las políticas de cada uno.

Gestión sencilla de XML y JSON

Apigee incluye políticas que facilitan la conversión entre XML y JSON, así como la transformación de XML con XSL.

Convertir JSON en XML

La política JSONtoXML toma tu entrada JSON y la convierte en XML.

En el siguiente ejemplo de política, la política toma un mensaje con formato JSON de la variable request y, a continuación, sustituye el valor de la variable por un mensaje con formato XML. La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.

<JSONToXML name="jsontoxml">
     <Source>request</Source>                     ---> INPUT
     <OutputVariable>request</OutputVariable>          OUTPUT --->
</JSONToXML>

Convertir XML en JSON

La política XMLtoJSON convierte el mensaje de entrada XML en JSON.

En el siguiente ejemplo de política, la política toma un mensaje con formato XML de la variable response y, a continuación, sustituye el valor de la variable por un mensaje con formato JSON. La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.

<XMLToJSON name="ConvertToJSON">
   <Source>response</Source>                     ---> INPUT
   <OutputVariable>response</OutputVariable>          OUTPUT --->
</XMLToJSON>

Transformar XML con XSL

Puedes usar la política XSLTransform para transformar mensajes mediante XSL. Por ejemplo, después de convertir una carga útil JSON a XML, puedes usar la política de transformación XSL con una hoja de estilo para realizar la transformación que necesites.

En el siguiente ejemplo de política, la política toma un mensaje con formato XML de la variable response y, a continuación, sustituye el valor de la variable por un mensaje con formato my_transform.xsl. La entrada se especifica en el elemento <Source>, mientras que la salida se especifica en el elemento <OutputVariable>.

<XSL name="TransformXML">
  <Source>response</Source>                        ---> INPUT
  <ResourceURL>xsl://my_transform.xsl</ResourceURL>       --TRANSFORMER--
  <OutputVariable>response</OutputVariable>                            OUTPUT --->
</XSL>

Gestionar datos de variables

El tratamiento de datos en un proxy suele consistir en trabajar con datos de estado como valores de variables de flujo. Para ello, suele utilizarse una política que obtiene o define valores de variables. Por ejemplo, puede que quieras dar forma a los valores de las variables en un mensaje o extraer el contenido de un mensaje para definir los valores de las variables.

Consulte las referencias de las dos políticas siguientes:

Crear transformaciones más complejas

Para el tratamiento de datos cuya complejidad supere las capacidades de las políticas incluidas, puedes usar lenguajes de procedimientos como JavaScript, Java o Python.

Por lo general, esto implica escribir código en uno de estos lenguajes y, a continuación, invocar el código desde una política específica del lenguaje. Para obtener más información, consulta Incorporar código de procedimiento.