Skip to content

Latest commit

 

History

History
103 lines (75 loc) · 3.1 KB

README.md

File metadata and controls

103 lines (75 loc) · 3.1 KB
Raw

Sistema de gerenciamento de pessoas em API REST com Spring Boot

Repositório com a VERSÃO PESSOAL do projeto prático "Desenvolvendo um sistema de gerenciamento de pessoas em API REST com Spring" da DIO

Neste projeto foi desenvolvido um pequeno sistema para o gerenciamento de pessoas através de uma API REST, criada com o Spring Boot.

Desenvolvimento

Foram desenvolvidas as seguintes tarefas:

  • Configurações iniciais de um projeto com o Spring Boot Initialzr
  • Criação de modelo de dados para o mapeamento de entidades em bancos de dados
  • Desenvolvimento de operações de gerenciamento de pessoas (Cadastro, leitura, atualização(integral) e remoção de pessoas do sistema) com o padrão arquitetural REST (GET, POST, PUT e DELETE)
  • Desenvolvimento de teste unitário para validação da funcionalidade (só para o método createPessoa, verificando a mensagem de retorno)
  • Implantação do sistema na nuvem através do Heroku

Tecnologias e Dependências utilizadas

  • Java 11
  • Maven 3.8.1
    • Lombok
    • Map Struct
    • H2 Database
  • Spring Boot (2.4.5)

    • Spring Boot DevTools

    • Spring Web

    • Spring Data JPA

    • Spring Boot Actuator

  • Git/GitHub para versionamento do código
  • Heroku para deploy na nuvem

Instalação e Execução

Para executar o projeto no terminal, digite o seguinte comando:

mvn spring-boot:run

Após executar o comando acima, basta apenas abrir o endereço http://localhost:8080/api/v1 + RECURSO e visualizar a execução do projeto:

MÉTODO RECURSO RESULTADO
GET /pessoas retorna lista de pessoas
GET /pessoas/{id} retorna uma pessoa específica
POST /pessoas cria uma nova pessoa
PUT /pessoas/{id} atualiza, de forma integral, uma pessoa
DELETE /pessoas/{id} deleta uma pessoa

Exemplo de corpo da requisição POST

{
    "nomePrimeiro": "Carlos Cláudia",
    "nomeUltimo": "Santos Caldeira",
    "cpf": "222.830.390-96",
    "dataNascimento": "25-04-1970",
    "telefones": [
        { "tipo": "CELULAR", "numero": "(86)98340-2284" },
        { "tipo": "CASA", "numero": "(86)98001-2284" }
    ]
}

Exemplo de uma requisição PUT

{
        "id": 3,
        "nomePrimeiro": "Carlos Cláudia",
        "nomeUltimo": "Santos Caldeira",
        "cpf": "095.729.960-53",
        "dataNascimento": "25-04-1970",
        "telefones": [
            {
                "id": 5,
                "tipo": "CELULAR",
                "numero": "(21)98340-2284"
            },
            {
                "id": 6,
                "tipo": "CASA",
                "numero": "(21)98001-2284"
            }
        ]
    }

Melhorias futuras

  • Desenvolvimento de testes unitários para validação de outras funcionalidades (negócio)
  • Desenvolvimento de operações de outros métodos HTTP (PATCH, HEAD e OPTION)