Шаблоны API Proxy Cookbook

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

В этой статье описаны некоторые шаблоны разработки прокси-серверов 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.

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