Este projeto consiste em um desafio técnico, que foi uma das etapas de um processo de recrutamento e seleção feito por uma empresa de Bauru/SP.

Divisão do projeto

O projeto foi divido em três partes:

• servico-api: API RestFull utilizada para disponibilizar os dados para outras aplicações;
• servico-client: client Web da API servico-api;
• servico-mysql-server: projeto Maven utilizado para criar uma imagem Docker contendo o banco de dados MySQL. Ao iniciar um container a partir dessa imagem será criado o banco servico, que é utilizado pela aplicação servico-api para persistir os dados.

Tecnologias utilizadas no projeto:

Spring Framework

Módulos utilizados:

• Spring Web: utilizado para a criação da API RestFull servico-api e do client servico-client;
• Spring Data: usado para persistir os dados no banco MySQL;
• Thymeleaf: Template Engine utilizado para criar as views do client;
• Devtools: ferramenta usada para fazer HotDeploy da aplicação após cada alteração do projeto;
• LiveReload: plugin usado para recarregar o navegador a cada alteração nas views;
• Spring Test: módulo utilizado para a criação dos Testes de Integração;
• Spring Boot Maven Plugin: plugin Maven utilizado para criar o artefato executável de projetos Spring Spring Boot.
• Spring Cloud: módulo utilizado no projeto servico-client para consumir os recursos da API servico-api;

Maven:

Plugins utilizados:

• Docker Maven Plugin: plugin utilizado para criar imagens de projetos Maven;
• Jacoco Maven Plugin: plugin usado para criar relatórios de testes e validar se a porcentagem de cobertura de testes foi alcançada;
• Spring Boot Maven Plugin: este plugin é utilizado para criar artefatos executáveis de projetos Spring Boot.

Perfis disponíveis:

• docker: este perfil permite criar imagens Docker;
• test: ao ativar esse perfil a axecução dos testes será habilitada, e o plugin Jacoco irá criar relatórios de testes e validar se a porcentagem de cobertura de testes foi alcançada;

Swagger

Foi o framework utilizado para documentar a API servico-client. Para visualizar a documentação, basta acessar o recurso /api-doc.

Obtendo as imagens Docker

As imagens dos três projetos encontram se armazenadas no Dockerhub, com os nomes: helciodasilva/servico-api, helciodasilva/servico-client e helciodasilva/servico-mysql-server.

Para clonar uma das imagens basta executar o comando:

git pull helciodasilva/<imagem-desejada>:v1

Também é possível criar imagens a partir dos projetos.

Para os projetos servico-api e servico-client será necessário gerar o artefato do projeto e ativar o perfil docker.

mvn package -P docker

Já para o projeto servico-mysql-server basta apenas executar o plugin docker.

mvn docker:build

Criando containers a partir das imagens

Para que os containers se comuniquem é necessário que os mesmos sejam interligados, por esse motivo, o container criado a partir da imagem servico-mysql-server deverá ser chamado mysql e o container de servico-api deverá chamar api.

servico-mysql-server:

docker run -p 3306:3306 -d --name mysql helciodasilva/servico-mysql-server:v1

servico-api:

docker run -p 8080:8080 -d --link mysql:mysql --name=api helciodasilva/servico-api:v1

servico-client:

docker run -p 8081:8081 -d --link api:api helciodasilva/servico-client:v1