Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/michelereginabora/crud-java-spring
Este projeto é uma aplicação Spring Boot que implementa operações CRUD (Create, Read, Update, Delete) para a entidade Person. Utiliza Spring Web para criar uma API RESTful, Lombok para redução de boilerplate code, e Swagger para documentação da API.
https://github.com/michelereginabora/crud-java-spring
crud java spring-boot
Last synced: about 1 month ago
JSON representation
Este projeto é uma aplicação Spring Boot que implementa operações CRUD (Create, Read, Update, Delete) para a entidade Person. Utiliza Spring Web para criar uma API RESTful, Lombok para redução de boilerplate code, e Swagger para documentação da API.
- Host: GitHub
- URL: https://github.com/michelereginabora/crud-java-spring
- Owner: michelereginabora
- Created: 2024-09-07T15:38:51.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-09-08T13:36:07.000Z (4 months ago)
- Last Synced: 2024-09-08T18:55:43.849Z (4 months ago)
- Topics: crud, java, spring-boot
- Language: Java
- Homepage:
- Size: 16.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Person CRUD Project
Este projeto é uma aplicação Spring Boot que implementa operações CRUD (Create, Read, Update, Delete) para a entidade Person. Utiliza Spring Web para criar uma API RESTful, Lombok para redução de boilerplate code, e Swagger para documentação da API.
## Tecnologias Utilizadas
- Java 21+
- Spring Boot 3.3+
- Spring Web
- Spring Data JPA
- Lombok
- Swagger (SpringDoc OpenAPI)
- Maven
- PostgreSQL
## Configuração do Projeto
1. Clone o repositório:
```
git clone https://github.com/seu-usuario/crud-java-spring.git
```
2. Navegue até o diretório do projeto:
```
cd crud-java-spring
```
3. Compile o projeto:
```
mvn clean install
```
4. Execute a aplicação:
```
mvn spring-boot:run
```
A aplicação estará disponível em `http://localhost:8080`.
## Estrutura do Projeto
```
src
├── main
│ ├── java
│ │ └── com
│ │ └── example
│ │ └── personcrud
│ │ ├── controllers
│ │ │ └── PersonController.java
│ │ ├── models
│ │ │ └── PersonModel.java
│ │ ├── repositories
│ │ │ └── PersonRepository.java
│ │ └── PersonCrudApplication.java
│ └── resources
│ └── application.properties
```
## API Endpoints
- GET `/persons`: Retorna todas as pessoas
- GET `/persons/{id}`: Retorna uma pessoa específica por ID
- POST `/persons`: Cria uma nova pessoa
- PUT `/persons/{id}`: Atualiza uma pessoa existente
- DELETE `/persons/{id}`: Remove uma pessoa
## Documentação da API
A documentação da API está disponível através do Swagger UI. Após iniciar a aplicação, acesse:
```
http://localhost:8080/swagger-ui.html
```
## Desenvolvimento
### Pré-requisitos
- JDK 21
- Maven 3.6+
### Compilação
Para compilar o projeto, execute:
```
mvn clean install
```
### Testes
Para executar os testes, use:
```
mvn test
```
## Contribuindo
Contribuições são bem-vindas! Por favor, sinta-se à vontade para submeter um Pull Request.
## Licença
Este projeto está licenciado sob a licença MIT - veja o arquivo [LICENSE.md](LICENSE.md) para detalhes.