Формирование, получение и преобразование сообщений

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

Вы можете использовать правила, включенные в Apigee Edge, чтобы управлять сообщениями, проходящими через прокси API. Правила позволяют:

  • Преобразовывать сообщения из одного формата в другой, например из XML в JSON.
  • Устанавливать значения переменных на основе контента сообщений и создавать сообщения на основе значений переменных.
  • Используйте процедурный код, например JavaScript, Java и Python, чтобы обрабатывать сообщения и данные более сложными способами.

Как правило, при использовании этих правил входные и выходные данные задаются как переменные потока. Во время выполнения Apigee Edge извлекает входное значение из исходной переменной и записывает выходное значение в целевую переменную.

В этой статье рассказывается об этих возможностях. Более подробную техническую информацию можно найти в правилах, на которые приведены ссылки.

Простое управление XML и JSON

Apigee Edge включает правила, которые упрощают преобразование XML в JSON и наоборот, а также преобразование XML с помощью XSL.

Как преобразовать JSON в XML

Правило преобразования JSON в XML преобразует входные данные в формате JSON в XML.

В приведенном ниже примере правил сообщение в формате JSON из переменной request заменяется сообщением в формате XML. Входные данные указываются в элементе <Source>, а выходные – в элементе <OutputVariable>.

<JSONToXML name="jsontoxml">
     <Source>request</Source>
     <OutputVariable>request</OutputVariable>
</JSONToXML>

Как преобразовать XML в JSON

Правило преобразования XML в JSON преобразует входное сообщение XML в JSON.

В приведенном ниже примере правил сообщение в формате XML из переменной response заменяется сообщением в формате JSON. Входные данные указываются в элементе <Source>, а выходные – в элементе <OutputVariable>.

<XMLToJSON name="ConvertToJSON">
   <OutputVariable>response</OutputVariable>
   <Source>response</Source>
</XMLToJSON>

Преобразование XML с помощью XSL

Вы можете использовать правило преобразования XSL, чтобы преобразовывать письма с помощью XSL. Например, после преобразования полезной нагрузки JSON в XML можно использовать правило XSL Transform с таблицей стилей, чтобы выполнить нужное преобразование.

В примере ниже правило получает сообщение в формате XML из переменной response, а затем заменяет значение переменной сообщением, отформатированным с помощью my_transform.xsl. Входные данные указываются в элементе <Source>, а выходные – в элементе <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/>

Как работать с переменными данными

Обработка данных в прокси-сервере часто включает работу с данными состояния в качестве значений переменных потока. Часто это можно сделать с помощью правила, которое получает или задает значения переменных. Например, вы можете преобразовать значения переменных в сообщение или извлечь содержимое сообщения, чтобы задать значения переменных.

Ознакомьтесь со следующими правилами:

Создание более сложных преобразований

Для обработки данных, которая не предусмотрена встроенными правилами, можно использовать процедурные языки, такие как JavaScript, Java или Python.

Как правило, это предполагает написание кода на одном из этих языков, а затем вызов кода из правил, относящихся к этому языку. Подробнее о том, как добавить процедурный код…