/books-database

Um banco de dados onde é possível guardar informações de livros.

Primary LanguageJava

Boas vindas ao repositório do projeto Books Database

Continuos Integration with GitHub


Descrição do projeto

Neste projeto eu fui responsável por criar uma API REST responsável por gerenciar informações de livros utilizando Java com Spring-boot e o banco de dados MongoDB.


Instalação do projeto localmente

Após cada um dos passos, haverá um exemplo do comando a ser digitado para fazer o que está sendo pedido.

  1. Realize o clone do projeto no diretório de sua preferência:
  git clone git@github.com:humberto-bonadiman/books-database.git
  1. Acesse o diretório do projeto e depois utilize o comando mvn install para instalar todas as dependências necessárias:
  cd books-database
  mvn install
  1. Após empacote o código compilado com o comando mvn package:
  mvn package

Comandos para utilizar o Docker

Caso o MongoDB esteja ativo em sua máquina é necessário realizar o comando:

sudo service mongod stop

Para criar e iniciar os contêineres:
Obs.: Com o comando abaixo o docker fica rodando no terminal.

docker-compose up

Para criar e iniciar os contêineres em stand-by:

docker-compose up -d

Para realizar apenas a etapa de build das imagens que serão utilizadas:

docker-compose build

Para paralisar e remover todos os contêineres e seus componentes como rede, imagem e volume:

docker-compose down

Utilizando o Spring-boot sem o Docker

Primeiramente, ative o MongoDB:

sudo service mongod start

Rodar o Spring-Boot com o comando:

mvn spring-boot:run

Realização dos testes

Para realizar todos os testes da aplicação você pode utilizar o seguinte comando:

mvn clean test

Para realizar somente um teste específico você deve utilizar o comando:

mvn test -Dtest=O_nome_do_teste_vai_aqui

Documentação

Documentação Swagger

Para acessar a documentação pelo swagger rode o comando mvn spring-boot:run ou docker-compose up e acesse o projeto via browser, no caminho http://localhost:8081/swagger-ui/index.html ou pelo caminho http://localhost:8081/v3/api-docs.