Шаблоны кулинарной книги прокси API

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

В этой теме рассматриваются некоторые шаблоны разработки API-прокси, продемонстрированные в примерах Apigee Edge. По мере добавления новых примеров мы планируем добавить в эту тему и другие шаблоны.

Шаблон HTTP-клиента на JavaScript

Шаблон HTTP-клиента на JavaScript — один из нескольких шаблонов, которые можно использовать для создания серверных мэшапов с помощью Apigee Edge. Объектная модель JavaScript в Apigee позволяет напрямую встраивать код JavaScript в поток прокси-сервера API. Объект httpClient в объектной модели позволяет выполнять вызовы к бэкэнд-сервисам и получать результаты с помощью JavaScript.

Структура формирования политики

Композиция политик — это шаблон прокси-сервера API Apigee, позволяющий объединять результаты из нескольких целевых бэкэндов в один ответ с помощью политик. По сути, композиция политик позволяет создавать мэшапы с использованием политик.

В основе паттерна композиции политик лежит политика ServiceCallout . Политика ServiceCallout выступает в роли HTTP-клиента для бэкэнд-API или сервиса. Однако для полноценной работы ServiceCallout полагается на другие политики, обеспечивающие осмысленное взаимодействие с удаленным API или сервисом. Другие политики используются для генерации сообщения запроса, отправляемого ServiceCallout, и для анализа содержимого сообщения ответа от удаленного API или сервиса.

В примере построения политик используются три политики: AssignMessage , ServiceCallout и ExtractVariables . Эти политики инкапсулируют сообщение(я) запроса , которое(ые) вы хотите отправить на бэкэнд, клиент , который маршрутизирует сообщение на бэкэнд, и парсер сообщений , который анализирует ответ от каждого API и присваивает переменные для данных ответа. После выполнения всех вызовов собранные переменные объединяются и возвращаются в виде единого объекта JSON.

Вот краткое изложение этих трех политик:

  • AssignMessage : Создает сообщение запроса, заполняет заголовки HTTP и параметры запроса, устанавливает HTTP-метод.
  • ServiceCallout : Ссылается на сообщение, созданное политикой AssignMessage, определяет целевой URL-адрес для внешнего вызова и задает имя для объекта ответа, который возвращает целевая служба.
  • ExtractVariables : Обычно определяет выражение JSONPath или XPath, которое анализирует сообщение, сгенерированное предыдущей политикой ServiceCallout. Затем политика устанавливает переменные, содержащие значения, полученные из ответа ServiceCallout.

Полный пример, демонстрирующий модель композиции политики, см. в разделе «Использование композиции политики».