Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Você pode adicionar código em linguagens de procedimentos, como JavaScript, Java e Python, e chamar esse código de outras partes de um proxy de API. A compatibilidade com códigos procedurais é projetada para facilitar a implementação do tratamento complexo de variáveis de fluxo, falhas e corpos de solicitação e resposta.
Com o código processual, é possível:
- Crie ou manipule valores de corpo complexos, como valores de solicitação e resposta.
- Reescreva os URLs, como mascarar um URL do endpoint de destino.
- Adição de outra lógica não disponível com as políticas incluídas.
Como funciona
Use uma política específica da linguagem para fazer chamadas de um fluxo de proxy para seu código incluído. Para cada uma das linguagens compatíveis, o Apigee Edge inclui uma política separada: política JavaScript, política de chamada Java e política de script Python (em inglês).
Veja a seguir uma descrição em alto nível de uma maneira como isso funciona. Consulte as referências da política para mais detalhes.
- Em um arquivo separado, escreva o código que você usará.
- No código, coloque o resultado do processamento em uma variável de fluxo do Apigee Edge.
Você recuperará o valor da variável em outro lugar no seu proxy de API. Para mais informações sobre variáveis de fluxo, consulte Como gerenciar o estado de proxy com variáveis de fluxo.
- Adicione seu arquivo (ou JAR) como um arquivo de recurso ao proxy de API.
Para mais informações sobre arquivos de recursos, consulte Arquivos de recurso.
- Adicione a política correspondente ao idioma que você está usando.
Configure a política para fazer uma chamada ao código do lugar desejado no fluxo do proxy da API.
- Use uma política para recuperar o valor do código da variável de fluxo.
Limitações
O modelo de segurança da Apigee Edge não permite chamadas do sistema, como E/S de rede, leitura/gravação de sistema de arquivos, informações do usuário atual, lista de processos e utilização da CPU/memória. Embora algumas chamadas possam ser funcionais, elas não são compatíveis e responsáveis para serem suspensas a qualquer momento. Para compatibilidade com versões futuras, evite fazer essas chamadas no seu código.
Há outras limitações para cada linguagem compatível, conforme descrito na referência de política da linguagem.
Idiomas compatíveis
JavaScript
A compatibilidade com o JavaScript inclui um modelo de objeto completo para lidar com variáveis e valores específicos de um proxy de API. Para mais informações, consulte o Modelo de objeto do JavaScript.
Para informações de referência de política e exemplos, consulte a política de JavaScript e os proxies de API de programação com JavaScript. Para ver um exemplo de código, pesquise na lista de amostras aqueles com JavaScript incluído.
Java
Use a política da chave do Java para fazer chamadas para o código Java a partir do fluxo do seu proxy. O tópico de referência da política inclui exemplos.
Talvez você também tenha interesse nos seguintes tópicos:
- Como criar uma chamada em Java
- Como lidar com erros de chamada em Java
- Como usar propriedades em uma chamada em Java
Para ver um código de amostra, pesquise na lista de amostras aqueles com Java incluído.
Python
Use a política de script em Python para chamar o código Python.
Para ver exemplos de código, pesquise na lista de amostras os códigos com o Python incluído.