Custom JavaScript Interceptors

Diferente dos interceptores personalizados Java, que precisam ser subidos para a Plataforma por meio de um arquivo .jar, os interceptores JavaScript são criados diretamente na tela do Manager.

Como criar um custom JavaScript interceptor

Novos interceptores são criados na página do menu Interceptors, por meio do botão +, no canto inferior direito da tela.

custom create

Para criar um interceptor JavaScript, clique ou passe o cursor pelo botão + e selecione a opção Create Custom JavaScript.

custom js create

O editor (veja a imagem abaixo) será aberto, e você poderá configurar o seu interceptor.

custom js editor

Configurando o interceptor

Insira o nome do interceptor no campo Name. A opção Abort request if fail pode ser marcada para abortar a requisição se algum erro ocorrer.

O campo para edição de código é onde o usuário deve inserir o script que será executado pelo interceptor. Você pode ler mais sobre isso abaixo.

No campo Tags, o usuário pode criar ou utilizar tags já existentes para categorizar o interceptor. Se nenhuma for inserida, a tag Uncategorized será atribuída.

O campo Visibility permite que você escolha o nível de visibilidade do interceptor. Para entender as regras de visibilidade, clique aqui.

Os interceptores personalizados JavaScript podem ser usados tanto no fluxo de requisição quanto no de resposta. Ou seja, eles podem modificar chamadas antes de uma requisição ser completada ou após uma resposta do backend ser enviada ao gateway.

Listagem de JavaScript interceptors

Os interceptores JavaScript existentes são exibidos em cards separados por tags. Os interceptores que não forem atribuídos a uma tag serão listados na categoria Uncategorized e com uma etiqueta sinalizando que se tratam de custom JavaScript interceptors.

custom js list

Para saber a quais tags um custom interceptor especifico está atribuído, basta clicar no ícone icon tags e uma janela modal contendo as tags aparecerá na tela.

custom tags

Editando o interceptor

Para editar um interceptor, basta clicar no ícone exibido na listagem, o que irá abrir o editor (veja as imagens abaixo).

custom js edit
custom js editor
custom js editor1
Quando houver qualquer edição do interceptor fora do fluxo de execução, ele deverá ser completamente removido de todos os pontos de execução e inserido novamente. Isso acontece pois edições feitas em um interceptor não são refletidas em suas instâncias que já estejam adicionadas aos fluxos.

Removendo um interceptor

Para remover um custom interceptor, basta entrar no editor e clicar no botão Delete Interceptor. Em seguida, as APIs em que o interceptor está sendo utilizado serão exibidas e será possível confirmar a exclusão clicando no botão Delete.

custom js delete

Funcionamento e scripts

Neste tipo de transformação, um trecho de código JavaScript é cadastrado no API Manager e enviado para o API Gateway.

Os scripts inseridos no editor são os códigos a serem executados para manipular as requisições e respostas desejadas. Cada script pode incluir uma estrutura de dados representando a requisição e resposta atuais e uma série de utilitários. Ele pode modificar a requisição, a resposta, ou disparar outros processos usando os dados da chamada atual.

A interpretação do script é feita usando JavaScript engine dentro da JVM (Rhino no Java 1.7 ou Nashorn no Java 1.8). Observe, no entanto, que pode haver perda de performance se vários scripts complexos tiverem que ser executados em cada chamada.

Com os itens desta subseção, você pode entender melhor como criar scripts para as ações que você necessita. Além destas explicações e referências mais gerais, você pode encontrar uma série de exemplos de scripts aqui.

Referência

Você pode utilizar uma série de variáveis implícitas e utilitários no código do interceptor JavaScript:

Variable Description

$call

Este objeto agrupa todos os dados relacionados com a chamada atual, incluindo o request, o response, e outros dados produzidos durante o processamento do API Gateway.

$request

Atalho para $call.request.

$response

Atalho para $call.response.

$base64

Utilitário para codificar e decodificar Base64.

$http

Utilitário para realizar chamadas HTTP a outros servidores.

$jdom

Utilitário para parse e formatação de XML.

$json

Utilitário para parse e formatação de JSON.

$cookies

Utilitário para parse de cookies.

$console

Utilitário para usar no debug do custom.

$gzip

Utilitário para compactação e descompactação de arquivos.

$billing

Utilitário para manipulação do serviço de billing.

Javadoc

Aqui você pode acessar o Javadoc dos objetos $call, $request e $response:

E aqui o Javadoc das classes utilitárias:

Pontos de Execução

O custom interceptor pode ser executado na requisição ou na resposta. Quando executado na requisição, somente os valores do objeto $request deverão ser alterados. Quando executado na resposta, somente os valores do objeto $response deverão ser alterados.

Debug

O interceptor JavaScript tem a possibilidade de executar uma depuração de código. Para utilizar a funcionalidade de debug, basta adicionar a linha de código abaixo e habilitar o debug no editor (veja a imagem abaixo).

$console.debug("identifier", value);
custom js debug

Para visualizar os resultados do debug, entre no Trace e abra os detalhes da chamada realizada. A aba Gateway Trace exibirá as linhas que foram executadas, conforme a imagem abaixo.

custom js debug trace

Clicar no ícone de inseto para visualizar os detalhes do debug.

custom js debug details
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]