Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
Puedes agregar código en lenguajes de procedimiento como JavaScript, Java y Python, y luego llamar a ese código desde otras partes de un proxy de API. La asistencia para el código de procedimientos está diseñada para que sea más fácil implementar un control complejo de variables de flujo, fallas y cuerpos de solicitud y respuesta.
Con el código de procedimiento, puedes hacer lo siguiente:
- Crear o manipular valores de cuerpo complejos, como valores de solicitud y respuesta
- Volver a escribir las URL, como para enmascarar una URL de extremo de destino
- Agregar otra lógica que no esté disponible con las políticas incluidas
Cómo funciona
Usa una política específica del lenguaje para realizar llamadas desde un flujo de proxy a tu código incluido. Para cada uno de los lenguajes compatibles, Apigee Edge incluye una política independiente: política de JavaScript, política de texto destacado de Java y política de Python Script.
A continuación, se describe, en un nivel alto, una forma en que funciona. Asegúrate de ver las referencias de la política para obtener más detalles.
- En un archivo separado, escribe el código que vas a usar.
- En el código, coloca el resultado del procesamiento en una variable de flujo de Apigee Edge.
Recuperarás el valor de la variable en otro lugar del proxy de API. Para obtener más información sobre las variables de flujo, consulta Administra el estado del proxy con variables de flujo.
- Agrega tu archivo (o JAR) como archivo de recursos a tu proxy de API.
Para obtener más información sobre los archivos de recursos, consulta Archivos de recursos.
- Agrega la política correspondiente al idioma que usas.
Configura la política para realizar una llamada a tu código desde el lugar deseado en el flujo del proxy de API.
- Usa una política para recuperar el valor del código de la variable de flujo.
Limitaciones
El modelo de seguridad de Apigee Edge no permite llamadas al sistema como E/S de red, operaciones de lectura y escritura del sistema de archivos, información de usuario actual, lista de procesos y uso de CPU/memoria. Aunque algunas de estas llamadas pueden ser funcionales, no son compatibles y son responsables de inhabilitarse de forma activa en cualquier momento. Para garantizar la compatibilidad con versiones futuras, debes evitar realizar este tipo de llamadas en tu código.
Existen otras limitaciones para cada lenguaje admitido, como se describe en la referencia de la política correspondiente del lenguaje.
Idiomas admitidos
JavaScript
La compatibilidad con JavaScript incluye un modelo de objetos completo para controlar variables y valores específicos de un proxy de API. Para obtener más información, consulta el modelo de objetos de JavaScript.
Para obtener información de referencia de políticas y ejemplos, consulta la política de JavaScript y los proxies de API de programación con JavaScript. Para obtener un código de muestra, busca en la lista de muestras aquellos que incluyan JavaScript.
Java
Usa la política de texto destacado de Java para realizar llamadas al código de Java desde el flujo de tu proxy. En el tema de referencia de la política, se incluyen ejemplos.
También te pueden interesar los siguientes temas:
- Cómo crear un texto destacado de Java
- Cómo manejar los errores de texto destacado de Java
- Cómo usar las propiedades en un texto destacado de Java
Para ver el código de muestra, busca la Lista de muestras con Java incluido.
Python
Usa la política de secuencia de comandos de Python para llamar al código de Python.
Para ver un código de muestra, busca la Lista de muestras con Python incluido.