Repositório: yanvferreira/todolist

TodoList

API para gerenciar tarefas (CRUD) que faz parte desse desafio para pessoas desenvolvedoras backend júnior, que se candidatam para a Simplify.

O projeto foi usado para aprender a desenvolver API com Spring Boot como mostrado nesse vídeo.

Tecnologias

• Spring Boot
• Spring MVC
• Spring Data JPA
• Spring Validation
• SpringDoc OpenAPI
• PostgreSQL
• Postman

Práticas adotadas

• SOLID, DRY, YAGNI, KISS
• API REST
• Consultas com Spring Data JPA
• Injeção de Dependências
• Tratamento de respostas de erro
• Geração automática do Swagger com a OpenAPI

Como Executar

• Clonar repositório git
• Construir o projeto:

$ ./mvnw clean package

• Executar a aplicação:

$ java -jar target/todolist-0.0.1-SNAPSHOT.jar

A API poderá ser acessada em localhost:8080. O Swagger poderá ser visualizado em localhost:8080/swagger-ui.html

API Endpoints

Para fazer as requisições HTTP abaixo, foi utilizada a ferramenta Postman:

• Criar Tarefa

$ http POST :8080/todos

[
  {	  
    "nome": "Todo 1",
    "descricao": "Desc Todo 1",
    "prioridade": 1,
    "realizado": false
  }
]

• Listar Tarefas

$ http GET :8080/todos

• Atualizar Tarefa

$ http PUT :8080/todos/1 

[
  {
	"id": 1,
    "nome": "Todo 1 Up",
    "descricao": "Desc Todo 1 Up",
    "prioridade": 2,
    "realizado": false
  }
]

• Remover Tarefa

http DELETE :8080/todos/1