Este é um projeto inicial de base para uma RESTful API de catálogo, que gerencia alunos e cursos. Bastante simples, foi desenvolvida em Java e Spring Boot para gerenciar alunos e cursos --- como primeiro contato com o Spring Boot. Não possui persistência de dados.
Sou a Barbara Calderon, desenvolvedora de software.
- Java 17: linguagem de programação Java com JDK 17.
- Spring Boot: framework para desenvolvimento de aplicações Java
- Spring Boot Starter Web: para desenvolvimento de aplicativos da web
- Spring Boot DevTools: ferramenta para desenvolvimento mais produtivo
- Project Lombok: para reduzir a verbosidade do código Java
- Maven: gerenciador de dependências e construção de projetos
Sistema conta apenas com sete endpoints simples, descritos abaixo.
Endpoint | Método HTTP | Descrição |
---|---|---|
/aluno | GET | Retorna todos os alunos cadastrados. |
/aluno/{idAluno} | GET | Retorna um aluno específico pelo ID. |
/aluno | POST | Cadastra um novo aluno. |
Endpoint | Método HTTP | Descrição |
---|---|---|
/curso | GET | Retorna todos os cursos cadastrados. |
/curso/{idCurso} | GET | Retorna um curso específico pelo ID. |
/curso | POST | Cadastra um novo curso. |
/curso/{idCurso}/matricula | POST | Matricula um aluno em um curso específico. |
Antes de executar o projeto, certifique-se de ter o JDK 17 e o PostgreSQL instalados em sua máquina.
-
Clone o repositório do projeto:
git clone [email protected]:barbaracalderon/fmt-educational-catalog.git
-
Acesse o diretório do projeto:
cd fmt-educational-catalog
-
Execute o projeto:
./mvnw spring-boot:run
O servidor será iniciado em https://localhost:8080.
Você pode testar os endpoints utilizando ferramentas como o Insomnia, Postman ou cURL. Abaixo estão alguns exemplos de como testar os endpoints:
Você pode testar os endpoints utilizando ferramentas como Postman ou Insomnia. Por exemplo:
-
Para listar todos os alunos:
GET https://localhost:8080/alunos
-
Para cadastrar um novo aluno:
POST https://localhost:8080/aluno Body: { "nomeDoAluno": "Maria", "dataDeNascimento": "2000-01-01" }
Certifique-se de substituir os valores de exemplo pelos valores reais.
Esta foi uma atividade da semana 8, execução própria de uma proposta de primeiro contato com construção de APIs no ecossistema Java.