api-rest-person

KO | EN

gitlite — search

#javascript #hacktoberfest #react #typescript #golang #go #rust #deep-learning #linux #java #windows #awesome #cli #awesome-list

api-rest-person

(★ 12)

Crud pessoa utlizando Spring Boot

api-rest-person Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h2>API REST CRUD pessoas com Spring Boot</h2>

### Pontos importantes do projeto
* Setup inicial de projeto com o Spring Boot Initialzr 
* Criação de modelo de dados para o mapeamento de entidades em bancos de dados
* Operações implementadas (Cadastro, leitura, atualização e exclusão de pessoas de um sistema).
* Relação de cada uma das operações acima com o padrão arquitetural REST.
* Testes unitários implementado para validação das funcionalidades
* Implantação do sistema na nuvem através do Heroku

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

```
mvn spring-boot:run

```

Após executar o comando acima, basta apenas abrir o seguinte endereço e visualizar a execução do projeto:

```
http://localhost:8081/api/v1/people

```
Pré-requisitos para a execução do projeto desenvolvido:

* Java 11 ou versões superiores.
* Maven 3.6.3 ou versões superiores.
* Uma IDE exemplo Intellj IDEA Community Edition, Eclipse ou qualquer outra de sua escolha.

Abaixo, seguem links bem bacanas:

* [SDKMan! para gerenciamento e instalação do Java e Maven](https://sdkman.io/)
* [Site oficial do Spring](https://spring.io/)
* [Site oficial do Spring Initialzr, para setup do projeto](https://start.spring.io/)
* [Site oficial do Heroku](https://www.heroku.com/)
* [Site oficial do GIT](https://git-scm.com/)
* [Site oficial do GitHub](http://github.com/)
* [Documentação oficial do Lombok](https://projectlombok.org/)
* [Documentação oficial do Map Struct](https://mapstruct.org/)
* [Referência para o padrão arquitetural REST](https://restfulapi.net/)

## Banco de dados:
Neste exemplo no pom.xml adicionei o H2 para testes locais.
Porém nada impede que você adicione qualquer outro banco de dados de sua preferência. ☺️

### Para Acessar o banco h2 console após execultar o projeto.
* http://localhost:8081/h2-console  
* Nome do banco de dados: testdb
* Adicionar na URL o nome do banco desta forma : jdbc:h2:mem:testdb
### Padrão DTO utilizado neste projeto. 
Um dos objetivos de receber uma classe dto como argumento é o tratamento de exceção <br />
Se fossemos receber uma classe de entidade de banco de dados e ocorrer algum tipo de exceção <br />
Iriamos ter exceção expecificas do banco de dados em nossa aplicação e seria algo mais complicado de tratar. <br />

### map struct biblioteca.org
disponibiliza através de uma unica interface,  faz uma conversão de um objeto de uma entidade para um DTO e de um DTO para uma entidade.
é preciso adicionar a dependencia mapstruct no pom.xml

### Postman 🚀🚀

### Registrando uma pessoa na base de dados utilizando o Postamn

* POST - Create 
http://localhost:8081/api/v1/people

```
{
      
        "firstName": "Renato",
        "lastName": "Ferreira",
        "cpf": "330.903.750-95",
        "birthDate": "01-01-2001",
        "phones":[
            {
                "type": "MOBILE",
                "number": "(81)888888888"
            }
        ]

}

```
* ![](https://github.com/renatoredes/api-rest-person/blob/main/screenshot/post.png)

* Put - Update
* ![](https://github.com/renatoredes/api-rest-person/blob/main/screenshot/update.png)

* Get - List
* ![](https://github.com/renatoredes/api-rest-person/blob/main/screenshot/get.png)
 
### Outras operações podem ser realizadas conforme print de exemplo do Postman
* GET
* PUT
* DELETE

## 👨👩 Social [🔝](#welcome-badges-4-readmemd-profile)

Badge | URL
------------ | -------------
<img src="https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white" /> | [Renato](https://www.linkedin.com/in/renatoredes/)<br />

api-rest-person

api-rest-person Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

api-rest-person

api-rest-person Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README