Aspectual fi insertion, event building and intervention

Atualmente tem se tornado cada vez mais difícil desenvolver uma aplicação sem considerar pelo menos uma vez a sua integração com outras plataformas e aplicações. Para isso existem inúmeras formas consolidadas de se fazer tal integração, porém dentre todas elas

50

uma vem ganhando destaque, a abordagem da arquitetura REST. Uma definição é apresenta a seguir.

REST é o acrônimo de REpresentational State Transfer (Transferência de Estado Representativo) e pode ser definido como um conjunto de boas práticas de uso do protocolo HTTP para expor webservices, ou seja, serviços responsáveis por executar determinada lógica ou regra de negócio, geralmente utilizados para integração entre aplicações. (COUTO e FOSCHINI, 2015).

5.8.5.1 Spark

O Spark dá suporte à arquitetura REST de forma muito simples e fácil. Para tal é necessário que o projeto possua como umas de suas dependências uma biblioteca de manipulação de JSON (JavaScript Object Notation), por exemplo, o GSON do Google, em cada método do Controller declare explicitamente que o conteúdo da resposta será JSON, informando também o statusCode da requisição e finalmente retornando um objeto para ser serializado. A Figura 19 demonstra um exemplo desse uso.

Figura 19 – Exemplo de uso do REST com Spark.

Fonte: Elaborado pelo Autor.

5.8.5.2 Jooby

O Jooby também dá suporte à arquitetura REST, porém ele possui módulos nativos de bibliotecas de manipulação de JSON especificas, são elas: Jackson, Gson e Yasson. Para que as requisições e respostas sejam realizadas usando JSON é necessário usar as annotations “@Produces(‘application/json’)” e “@Consumes(‘application/json’)” (isso pode ser visualizado na Figura 9) em cada Controller e ao decorrer da codificação dos métodos, jogar exceções do tipo “Err(statusCode, message)” no caso de erros, informando o statusCode e a mensagem de erro. A Figura 20 demonstra isso.

51

Figura 20 - Exemplo de uso do REST com Jooby.

Fonte: Elaborado pelo Autor.

5.8.5.3 Pippo

No Pippo, no que diz respeito à manipulação dos tipos de conteúdos existem classes nativas da ferramenta que tratam disso, as chamadas content type engines. Para JSON o Pippo possui três: “GsonEngine”, “FastJsonEngine” e “JacksonJsonEngine”. Cada uma usando uma biblioteca de manipulação de JSON diferente.

É possível também criar um content type engine customizado, bastando apenas implementar a interface “ContentTypeEngine”. Para registrá-lo existem duas formas: declarar na classe da aplicação que irá usá-la através do método “registerContentTypeEngine” ou criar um inicializador.

Para que seja efetivamente retornado o JSON é obrigatório o uso da annotation “@Produces (Produces. JSON)” em cada método que precisar retornar um JSON. A manipulação do statusCode é feita através do método “getResponse. status (statusCode)”. A Figura 20 ilustra essa funcionalidade.

52

Figura 21 – Exemplo de uso do REST com o Pippo.

Fonte: Elaborado pelo Autor.

No Quadro 12 são sumarizados os resultados desse critério de comparação. Quadro 12 – Resultados da avaliação do suporte a arquitetura REST.

Micro framework Suporte a arquitetura REST

Spark Disponível

Jooby Disponível

Pippo Disponível

Fonte: Elaborado pelo Autor.

5.8.6 Validação

A validação dos dados da entrada de um sistema deve ser considerada pelo desenvolvedor como uma parte muito importante no desenvolvimento de um software, já que ela garante alguns benefícios consideráveis, como por exemplo, consistência dos dados no banco de dados, boa qualidade do produto de software desenvolvido e fluxo continuo e fluido de navegação na aplicação, uma vez que os dados transitados na aplicação são válidos. (BONFIM, RAMOS, et al., 2010).

5.8.6.1 Spark

No Spark a validação da entrada de dados do usuário pode ser feita através de um recurso nativo da própria ferramenta denominado Filter. Existem dois tipos de Filters os

before (antes) e os after (depois), nesse caso o “antes” e o “depois” são em relação às

requisições HTTP.

É possível optar entre um filtro para todas as requisições ou um filtro para rotas especificas. Existe ainda uma sutil diferença de sintaxe no desenvolvimento de APIs de script

53

e utilizando o padrão MVC. Nas Figuras 22 e 23 são mostrados exemplos mais detalhados para APIs de script.

Figura 22 – Exemplo de Filter para todas as requisições em uma API de script com Spark.

Fonte: http://Spark.com/

Figura 23 – Exemplo de Filter para uma rota em uma API de script com Spark.

Fonte: http://Spark.com/

Os exemplos de código das Figuras 22 e 23 contém um elemento chamado halt (), sua função é parar imediatamente a requisição retornando para o cliente o status code e uma mensagem, ele geralmente é usado em conjunto com um Filter.

Em se tratando do desenvolvimento utilizando o padrão MVC o código é escrito seguindo a mesma sintaxe vista anteriormente na Figura 8, a de função lambda. A Figura 24 contém um exemplo de código retirado da aplicação de teste, somente para ilustrar o que já foi falado.

Figura 24 – Exemplo de Filter no padrão MVC com Spark.

54

5.8.6.2 Jooby

Para o Jooby a validação dos dados de entrada do usuário também é feita utilizando

Filters próprios, com basicamente os mesmos elementos usados no Spark (berfore e after),

porém há uma pequena diferença na sintaxe, a presença do elemento “chain”. A Figura 25 demonstra isso.

Figura 25 – Exemplo de um Filter no Jooby

Fonte: https://jooby.io/v1/doc/#routes-request-handling

O Jooby não oferece suporte para Filters no formato convencional das aplicações que utilizam o padrão MVC, formato esse visto na Figura 23.

5.8.6.3 Pippo

No Pippo, assim como nos outros micro framework avaliados, são utilizados Filters para a validação de entradas. Um filter no Pippo é essencialmente um Route que não retorna uma resposta e sim dá seguimento na cadeia de execução da aplicação. A sintaxe para before e

after filters muda um pouco em relação aos demais. As Figuras 26 e 27 ilustram os exemplos

de before e after respectivamente.

Figura 26 – Exemplo de código com um before filter no Pippo.

55

Figura 27 - Exemplo de código com um after filter no Pippo.

Fonte: http://www.pippo.ro/doc/filters.html

No Quadro 13 são sumarizados os resultados desse critério de comparação. Quadro 13 – Resultados da avaliação do suporte a validação da entrada.

Micro framework Suporte a validação da entrada

Spark Disponível

Jooby Disponível

Pippo Disponível

Fonte: Elaborado pelo Autor.