ronnylrsd / place-service

Place Service

Projeto - API de lugares com Spring Boot

Projeto   |    Tecnologias   |    Práticas Adotadas   |    Ambiente   |    Como executar   |    Colaborador

💻 Projeto

Projeto Java utilizando o Spring Boot, criando uma API de lugares utilizando um banco de dados, campos de entidade de lugar (name, slug, state, createdAt, updatedAt), CRUD de lugares e um adicional de testes automatizados

✨ Tecnologias

Esse projeto foi desenvolvido com as seguintes tecnologias:

• Spring Boot
• Spring Webflux
• Spring Data
• R2DBC

👨‍🏫 Práticas Adotadas

Esse projeto foi desenvolvido segundo essas práticas:

• SOLID
• Testes automatizados
• Consultas com filtros dinâmicos usando o Query By Example
• API reativa na web e na camada de banco
• Uso de DTOs para a API
• Injeção de Dependências
• Geração automática do Swagger com a OpenAPI 3
• Geração de slugs automática com o Slugify
• Auditoria sobre criação e atualização da entidade

⚙️ Ambiente

Preparar o seu ambiente Java para projetos na sua máquina.

3 ferramentas principais, para baixar:

• Java SDK
• Visual Studio Code
• Spring Boot, pode ser instalado diretamento no vscode, aconselho também instalar o delux package do java

🚀 Como executar

• Clone o repositório
• Constuir o projeto:

 $ ./mvnw clean package

• Executar aplicação:

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

A API poderá ser acessada em [localhost:8080].

API Endpoints

Para fazer as requisições HTTP abaixo, você pode usar o httpie, Postman ou Insomnia.

• POST "/places"

http POST :8080/places name="Place" state="State"

HTTP/1.1 200 OK
Content-Length: 129
Content-Type: application/json

{
    "createdAt": "2023-07-24T15:10:05.000+00:00",
    "name": "Place",
    "slug": "place",
    "state": "State",
    "updatedAt": "2023-07-24T15:10:05.000+00:00"
}

👷 COLABORADOR

Nome: Ronny Lima Ribeiro da Silva

• Registro do Aluno (RA): 00000009775
• LinkedIn: ronnylrsd
• GitHub: ronnylrsd

---

Projeto desenvolvido a partir de aulas do Youtube