Dicas com Custom Interceptor Java

Uma das opções de interceptors customizados que a plataforma da Sensedia disponibiliza é o intercetor Java. Com ele, podemos manipular o que desejarmos e até efetuarmos outras chamadas em tempo de execução do fluxo da chamada interceptada por nosso gateway. Para adicioná-lo no Manager basta gerar o arquivo .jar do projeto e efetuar o upload na plataforma.

Requisitos

Existem alguns requisitos para que esse interceptor seja aceito e funcione corretamente no Manager, e aqui vão eles:

• O interceptor deve ser implementado em Java 8 com o uso da openJDK;
• O interceptor pode depender apenas do que utilizamos em nossa plataforma (consultar no arquivo em anexo);
• O arquivo .jar gerado não pode ultrapassar 1Mb;
• No projeto deve conter ao menos uma classe com a anotação @ApiSuiteInterceptor;
• No projeto deve conter ao menos um método com a anotação @InterceptorMethod;
• Não deve conter outros .jar dentro do arquivo.
• É necessário fazer o uso desta dependência.

Um erro comum é no momento de compilar o código fonte no arquivo jar, ter selecionado além da pasta src pastas como bin e target. Isso pode gerar referências 'inválidas' a outros arquivos pom e outros jars. Nesse caso é necessário apenas a referencia do src.

Build

O build do projeto em si é bem simples. Uma das maneiras de efetuar esse build é utilizando o Maven. Para isso, basta isolar em uma pasta o arquivo pom e a pasta src do projeto. Após feito isso, é necessário apenas acessar a pasta com os itens indicados e executar o comando mvn clean package. Com isso, o .jar já estará gerado.

Upload na plataforma

Para enviar o interceptor para a plataforma e poder utilizá-lo, se faz necessário o acesso ao menu Interceptors, localizado a esquerda da interface do Manager. Após isso, basta posicionar o mouse no botão com o símbolo de "+" e selecionar a opção "create custom java", simbolizada pelo símbolo do java (xícara de café). Nos depararemos então com a seguinte interface:

Preencha os campos que são bem intuitivos e clique em Save. Pronto, o seu interceptor já está disponível na plataforma para ser utilizado.

Utilizando

Na interface de edição do fluxo da API, você localizará o interceptor java na aba referente a tag preenchida no upload do interceptor. Para utilizá-lo, basta arrastá-lo no ponto desejado do fluxo e selecionar o método que deseja executar. É possível também definir parâmetros estáticos, pois os dinâmicos podem ser acessados diretamente através do código Java do interceptor, tendo em vista que o parâmetro de call (ApiCallData) o Manager já preenche automaticamente.

Já sabendo todo o processo de implementação e utilização do interceptor, basta implementar o seu. E para facilitar, aqui vão alguns exemplos.