O projeto Cadastrar Contatos é uma aplicação para gerenciar contatos profissionais, fornecendo endpoints para realizar operações CRUD (Criar, Ler, Atualizar e Deletar) de contatos e profissionais. Ele foi desenvolvido em Java com o framework Spring Boot.
- Listar todos os contatos
- Filtrar contatos por termo de busca e campos específicos
- Obter detalhes de um contato por ID
- Cadastrar um novo contato associado a um profissional
- Atualizar os dados de um contato existente
- Deletar um contato
- Listar todos os profissionais
- Filtrar profissionais por termo de busca e campos específicos
- Obter detalhes de um profissional por ID
- Cadastrar um novo profissional
- Atualizar os dados de um profissional existente
- Deletar um profissional
O projeto está dividido em pacotes de controller, service, model e repository.
controller
: Contém os controladores responsáveis por receber as requisições HTTP, chamar os serviços correspondentes e retornar as respostas adequadas.service
: Contém a lógica de negócio da aplicação, onde são realizadas as operações sobre os dados.model
: Define as classes de modelo para os contatos e profissionais.repository
: Interface que estende JpaRepository para acesso aos dados no banco.
- Java 8 ou superior
- Maven
- Banco de dados (H2, MySQL, PostgreSQL, etc.)
-
Clone este repositório: git clone https://github.com/seu-usuario/seu-repositorio.git
-
Importe o projeto em sua IDE favorita.
-
Certifique-se de ter configurado corretamente o banco de dados no arquivo
application.properties
. -
Execute o projeto.
Swegger endpoints: http://localhost:8080/swagger-ui/index.html
Lista de contatos com base nos critérios definidos em Params.
q
- String: Filtro para buscar contatos que contenham o texto em qualquer um de seus atributos.fields
- List (Opcional): Quando presente, apenas os campos listados emfields
deverão ser retornados.
Retorna uma lista de contatos.
Retorna todos os dados do contato que possui o ID passado na URL.
Retorna os dados do contato com o ID especificado.
Insere no banco de dados os dados do contato enviados via body.
- Content-type: Json
Retorna "Sucesso: contato com id {ID} cadastrado" após a inserção.
Atualiza os dados do contato que possui o ID passado via URL com os dados enviados no Body.
- Content-type: Json
Retorna "Sucesso: contato alterado" após a atualização.
Exclui o contato que possui o ID passado na URL.
Retorna "Sucesso: contato excluído" após a exclusão.
Lista de profissionais com base nos critérios definidos em Params.
q
- String: Filtro para buscar profissionais que contenham o texto em qualquer um de seus atributos.fields
- List (Opcional): Quando presente, apenas os campos listados emfields
deverão ser retornados.
Retorna uma lista de profissionais.
Retorna todos os dados do contato que possui o ID passado na URL.
Retorna os dados do contato com o ID especificado.
Insere no banco de dados os dados do contato enviados via body.
- Content-type: Json
Retorna "Sucesso: contato com id {ID} cadastrado" após a inserção.
Atualiza os dados do contato que possui o ID passado via URL com os dados enviados no Body.
- Content-type: Json
Retorna "Sucesso: contato alterado" após a atualização.
Exclui o contato que possui o ID passado na URL.
Retorna "Sucesso: contato excluído" após a exclusão.