Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
Вы можете добавить код на процедурных языках, таких как JavaScript, Java и Python, а затем вызывать этот код из других частей прокси-сервера API. Поддержка процедурного кода призвана упростить реализацию сложной обработки переменных потока, ошибок, а также тел запросов и ответов.
С помощью процедурного кода вы можете:
- Создавайте или манипулируйте сложными значениями тела, такими как значения запроса и ответа.
- Перезапишите URL-адреса, например замаскируйте URL-адрес целевой конечной точки.
- Добавьте другую логику, недоступную для включенных политик.
Как это работает
Вы используете политику, специфичную для языка, чтобы совершать вызовы из прокси-потока в включенный код. Для каждого из поддерживаемых языков Apigee Edge включает отдельную политику: политику JavaScript , политику Java Callout и политику Python Script .
Ниже в общих чертах описан один из способов, которым это работает. Обязательно ознакомьтесь с ссылками на политику для получения более подробной информации.
- В отдельном файле напишите код, который собираетесь использовать.
- В своем коде поместите результат обработки кода в переменную потока Apigee Edge.
Вы получите значение переменной в другом месте вашего прокси API. Дополнительные сведения о переменных потока см. в разделе Управление состоянием прокси-сервера с помощью переменных потока .
- Добавьте свой файл (или JAR) в качестве файла ресурсов в прокси-сервер API.
Дополнительные сведения о файлах ресурсов см. в разделе Файлы ресурсов .
- Добавьте политику, соответствующую используемому вами языку.
Настройте политику для вызова вашего кода из нужного места в потоке прокси-сервера API.
- Используйте политику для получения значения кода из переменной потока.
Ограничения
Модель безопасности Apigee Edge не разрешает системные вызовы, такие как сетевой ввод-вывод, чтение/запись файловой системы, информация о текущем пользователе, список процессов и использование ЦП/памяти. Хотя некоторые такие вызовы могут быть работоспособными, они не поддерживаются и могут быть активно отключены в любое время. Для обеспечения прямой совместимости вам следует избегать подобных вызовов в вашем коде.
Для каждого поддерживаемого языка могут существовать и другие ограничения, как описано в соответствующей ссылке на политику языка.
Поддерживаемые языки
JavaScript
Поддержка JavaScript включает полную объектную модель для обработки переменных и значений, специфичных для прокси-сервера API. Дополнительные сведения см. в разделе Объектная модель JavaScript .
Справочную информацию и примеры политики см. в разделах «Политика JavaScript» и «Прокси-серверы API программирования с использованием JavaScript» . Чтобы найти пример кода, выполните поиск по списку примеров , включающему JavaScript.
Ява
Используйте политику Java Callout , чтобы выполнять вызовы кода Java из потока вашего прокси-сервера. Справочная тема по политике включает примеры.
Вам также могут быть интересны следующие темы:
- Как создать выноску Java
- Как обрабатывать ошибки Java Callout
- Как использовать свойства в выноске Java
Примеры кода можно найти в списке примеров, включающем Java.
Питон
Используйте политику Python Script для вызова кода Python.
Чтобы найти пример кода, найдите в списке примеров те, в которые включен Python.