Esta página se aplica ao Apigee e ao Apigee híbrido .
Veja a documentação do Apigee Edge .
Você pode adicionar código em linguagens procedurais como JavaScript, Java e Python e, em seguida, chamar esse código de outras partes de um proxy de API. O suporte a código procedural foi projetado para facilitar a implementação de manipulações complexas de variáveis de fluxo, falhas e corpos de solicitação e resposta.
Com o código processual, você pode:
- Crie ou manipule valores corporais complexos, como valores de solicitação e resposta.
- Reescreva URLs, por exemplo, para mascarar uma URL de ponto de extremidade de destino.
- Adicione outra lógica não disponível com as políticas incluídas.
Como funciona
Use uma política específica para a linguagem para fazer chamadas de um fluxo de proxy para o código incluído. Para cada uma das linguagens suportadas, a Apigee inclui uma política separada: política JavaScript , política JavaCallout e política PythonScript .
A seguir, descrevemos, em alto nível, como isso funciona. Consulte as referências de políticas para obter mais detalhes.
- Em um arquivo separado, escreva o código que você vai usar.
- No seu código, coloque o resultado do processamento do código em uma variável de fluxo do Apigee.
Você recuperará o valor da variável em outro lugar no seu proxy de API. Para saber mais sobre variáveis de fluxo, consulte Gerenciando o estado do proxy com variáveis de fluxo .
- Adicione seu arquivo (ou JAR) como um arquivo de recurso ao seu proxy de API.
Para mais informações sobre arquivos de recursos, consulte Arquivos de recursos .
- Adicione a política correspondente ao idioma que você está usando.
Configure a política para fazer uma chamada para seu código a partir do local desejado no fluxo do seu proxy de 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 não permite chamadas de sistema, como E/S de rede, leituras/gravações no sistema de arquivos, informações atuais do usuário, lista de processos e utilização de CPU/memória. Embora algumas dessas chamadas possam ser funcionais, elas não são suportadas e podem ser desativadas ativamente a qualquer momento. Para compatibilidade futura, evite fazer tais chamadas em seu código.
Podem existir outras limitações para cada idioma suportado, conforme descrito na referência de política correspondente ao idioma.
Idiomas suportados
JavaScript
O suporte para JavaScript inclui um modelo de objeto completo para manipular variáveis e valores específicos de um proxy de API. Para mais informações, consulte Modelo de objeto JavaScript .
Para obter informações de referência de política e exemplos, consulte Política de JavaScript .
Java
Use a política Java Callout para fazer chamadas ao código Java a partir do fluxo do seu proxy. O tópico de referência da política inclui exemplos.
Pitão
Use a política Python Script para chamar o código Python.
,Esta página se aplica ao Apigee e ao Apigee híbrido .
Veja a documentação do Apigee Edge .
Você pode adicionar código em linguagens procedurais como JavaScript, Java e Python e, em seguida, chamar esse código de outras partes de um proxy de API. O suporte a código procedural foi projetado para facilitar a implementação de manipulações complexas de variáveis de fluxo, falhas e corpos de solicitação e resposta.
Com o código processual, você pode:
- Crie ou manipule valores corporais complexos, como valores de solicitação e resposta.
- Reescreva URLs, por exemplo, para mascarar uma URL de ponto de extremidade de destino.
- Adicione outra lógica não disponível com as políticas incluídas.
Como funciona
Use uma política específica para a linguagem para fazer chamadas de um fluxo de proxy para o código incluído. Para cada uma das linguagens suportadas, a Apigee inclui uma política separada: política JavaScript , política JavaCallout e política PythonScript .
A seguir, descrevemos, em alto nível, como isso funciona. Consulte as referências de políticas para obter mais detalhes.
- Em um arquivo separado, escreva o código que você vai usar.
- No seu código, coloque o resultado do processamento do código em uma variável de fluxo do Apigee.
Você recuperará o valor da variável em outro lugar no seu proxy de API. Para saber mais sobre variáveis de fluxo, consulte Gerenciando o estado do proxy com variáveis de fluxo .
- Adicione seu arquivo (ou JAR) como um arquivo de recurso ao seu proxy de API.
Para mais informações sobre arquivos de recursos, consulte Arquivos de recursos .
- Adicione a política correspondente ao idioma que você está usando.
Configure a política para fazer uma chamada para seu código a partir do local desejado no fluxo do seu proxy de 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 não permite chamadas de sistema, como E/S de rede, leituras/gravações no sistema de arquivos, informações atuais do usuário, lista de processos e utilização de CPU/memória. Embora algumas dessas chamadas possam ser funcionais, elas não são suportadas e podem ser desativadas ativamente a qualquer momento. Para compatibilidade futura, evite fazer tais chamadas em seu código.
Podem existir outras limitações para cada idioma suportado, conforme descrito na referência de política correspondente ao idioma.
Idiomas suportados
JavaScript
O suporte para JavaScript inclui um modelo de objeto completo para manipular variáveis e valores específicos de um proxy de API. Para mais informações, consulte Modelo de objeto JavaScript .
Para obter informações de referência de política e exemplos, consulte Política de JavaScript .
Java
Use a política Java Callout para fazer chamadas ao código Java a partir do fluxo do seu proxy. O tópico de referência da política inclui exemplos.
Pitão
Use a política Python Script para chamar o código Python.
,Esta página se aplica ao Apigee e ao Apigee híbrido .
Veja a documentação do Apigee Edge .
Você pode adicionar código em linguagens procedurais como JavaScript, Java e Python e, em seguida, chamar esse código de outras partes de um proxy de API. O suporte a código procedural foi projetado para facilitar a implementação de manipulações complexas de variáveis de fluxo, falhas e corpos de solicitação e resposta.
Com o código processual, você pode:
- Crie ou manipule valores corporais complexos, como valores de solicitação e resposta.
- Reescreva URLs, por exemplo, para mascarar uma URL de ponto de extremidade de destino.
- Adicione outra lógica não disponível com as políticas incluídas.
Como funciona
Use uma política específica para a linguagem para fazer chamadas de um fluxo de proxy para o código incluído. Para cada uma das linguagens suportadas, a Apigee inclui uma política separada: política JavaScript , política JavaCallout e política PythonScript .
A seguir, descrevemos, em alto nível, como isso funciona. Consulte as referências de políticas para obter mais detalhes.
- Em um arquivo separado, escreva o código que você vai usar.
- No seu código, coloque o resultado do processamento do código em uma variável de fluxo do Apigee.
Você recuperará o valor da variável em outro lugar no seu proxy de API. Para saber mais sobre variáveis de fluxo, consulte Gerenciando o estado do proxy com variáveis de fluxo .
- Adicione seu arquivo (ou JAR) como um arquivo de recurso ao seu proxy de API.
Para mais informações sobre arquivos de recursos, consulte Arquivos de recursos .
- Adicione a política correspondente ao idioma que você está usando.
Configure a política para fazer uma chamada para seu código a partir do local desejado no fluxo do seu proxy de 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 não permite chamadas de sistema, como E/S de rede, leituras/gravações no sistema de arquivos, informações atuais do usuário, lista de processos e utilização de CPU/memória. Embora algumas dessas chamadas possam ser funcionais, elas não são suportadas e podem ser desativadas ativamente a qualquer momento. Para compatibilidade futura, evite fazer tais chamadas em seu código.
Podem existir outras limitações para cada idioma suportado, conforme descrito na referência de política correspondente ao idioma.
Idiomas suportados
JavaScript
O suporte para JavaScript inclui um modelo de objeto completo para manipular variáveis e valores específicos de um proxy de API. Para mais informações, consulte Modelo de objeto JavaScript .
Para obter informações de referência de política e exemplos, consulte Política de JavaScript .
Java
Use a política Java Callout para fazer chamadas ao código Java a partir do fluxo do seu proxy. O tópico de referência da política inclui exemplos.
Pitão
Use a política Python Script para chamar o código Python.
,Esta página se aplica ao Apigee e ao Apigee híbrido .
Veja a documentação do Apigee Edge .
Você pode adicionar código em linguagens procedurais como JavaScript, Java e Python e, em seguida, chamar esse código de outras partes de um proxy de API. O suporte a código procedural foi projetado para facilitar a implementação de manipulações complexas de variáveis de fluxo, falhas e corpos de solicitação e resposta.
Com o código processual, você pode:
- Crie ou manipule valores corporais complexos, como valores de solicitação e resposta.
- Reescreva URLs, por exemplo, para mascarar uma URL de ponto de extremidade de destino.
- Adicione outra lógica não disponível com as políticas incluídas.
Como funciona
Use uma política específica para a linguagem para fazer chamadas de um fluxo de proxy para o código incluído. Para cada uma das linguagens suportadas, a Apigee inclui uma política separada: política JavaScript , política JavaCallout e política PythonScript .
A seguir, descrevemos, em alto nível, como isso funciona. Consulte as referências de políticas para obter mais detalhes.
- Em um arquivo separado, escreva o código que você vai usar.
- No seu código, coloque o resultado do processamento do código em uma variável de fluxo do Apigee.
Você recuperará o valor da variável em outro lugar no seu proxy de API. Para saber mais sobre variáveis de fluxo, consulte Gerenciando o estado do proxy com variáveis de fluxo .
- Adicione seu arquivo (ou JAR) como um arquivo de recurso ao seu proxy de API.
Para mais informações sobre arquivos de recursos, consulte Arquivos de recursos .
- Adicione a política correspondente ao idioma que você está usando.
Configure a política para fazer uma chamada para seu código a partir do local desejado no fluxo do seu proxy de 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 não permite chamadas de sistema, como E/S de rede, leituras/gravações no sistema de arquivos, informações atuais do usuário, lista de processos e utilização de CPU/memória. Embora algumas dessas chamadas possam ser funcionais, elas não são suportadas e podem ser desativadas ativamente a qualquer momento. Para compatibilidade futura, evite fazer tais chamadas em seu código.
Podem existir outras limitações para cada idioma suportado, conforme descrito na referência de política correspondente ao idioma.
Idiomas suportados
JavaScript
O suporte para JavaScript inclui um modelo de objeto completo para manipular variáveis e valores específicos de um proxy de API. Para mais informações, consulte Modelo de objeto JavaScript .
Para obter informações de referência de política e exemplos, consulte Política de JavaScript .
Java
Use a política Java Callout para fazer chamadas ao código Java a partir do fluxo do seu proxy. O tópico de referência da política inclui exemplos.
Pitão
Use a política Python Script para chamar o código Python.