9 - Rota de cadastro

Com o repositório PessoaRepositorio pronto, agora podemos implementar a rota para cadastrar uma nova pessoa na nossa API.

No pacote br.com.api.pessoa, abra ou crie a classe PessoaController e adicione o método abaixo:

// Rota para cadastrar
@PostMapping("/cadastrar")
public Pessoa cadastrar(@RequestBody Pessoa p) {
    return repositorio.save(p);
}

Explicando passo a passo:

  • @PostMapping("/cadastrar") – cria um endpoint HTTP POST acessível em /cadastrar.
  • @RequestBody Pessoa p – indica que os dados da requisição serão recebidos no corpo da requisição e mapeados para a entidade Pessoa.
  • repositorio.save(p) – utiliza o repositório para salvar a pessoa no banco de dados. O Spring Data JPA já cuida de toda a operação de persistência.
  • O método retorna o objeto Pessoa cadastrado, incluindo o id gerado automaticamente pelo banco.

No vídeo abaixo, demonstro como criar a rota de cadastro: