Criando uma API Simples em Java: Parte 2 - Endpoints PUT e DELETE

ledilsonmenezes — Mon, 07 Oct 2024 22:19:03 +0000

Se você acompanhou a Parte 1 deste artigo, já está familiarizado com a criação de uma API REST básica usando Spring Boot. Agora, vamos adicionar mais funcionalidades à nossa API, incluindo os endpoints PUT e DELETE para gerenciar usuários.
Estrutura do Projeto

Primeiro, certifique-se de que você já tenha configurado um projeto Spring Boot com as dependências necessárias, como Spring Web e Spring Data JPA.
Endpoints da API
GET /usuarios/{id} - Busca um usuário pelo ID.
PUT /usuarios/{id} - Atualiza as informações de um usuário existente.
DELETE /usuarios/{id} - Deleta um usuário pelo ID.

Aqui está um exemplo de implementação:
Buscar Usuário

O método buscarUsuario é responsável por buscar um usuário específico com base no ID fornecido na URL. Se o usuário for encontrado, retornamos o usuário; caso contrário, retornamos um status 404 (Não Encontrado).

@GetMapping("/{id}") public ResponseEntity<Usuario> buscarUsuario(@PathVariable Long id) { return usuarioRepository.findById(id) .map(usuario -> ResponseEntity.ok(usuario)) .orElse(ResponseEntity.notFound().build()); }

Atualizar Usuário

O método atualizarUsuario permite atualizar as informações de um usuário. Primeiro, verificamos se o usuário existe. Se não existir, retornamos um status 404. Caso contrário, atualizamos o ID do usuário e salvamos as alterações no repositório.

@PutMapping("/{id}") public ResponseEntity<Usuario> atualizarUsuario(@PathVariable Long id, @RequestBody Usuario usuario) { if (!usuarioRepository.existsById(id)) { return ResponseEntity.notFound().build(); } usuario.setId(id); Usuario usuarioAtualizado = usuarioRepository.save(usuario); return ResponseEntity.ok(usuarioAtualizado); }
Deletar Usuário

Por fim, o método deletarUsuario permite remover um usuário da base de dados. Assim como no método de atualização, primeiro verificamos se o usuário existe. Se existir, deletamos o usuário e retornamos um status 204 (Sem Conteúdo).

@DeleteMapping("/{id}") public ResponseEntity<Void> deletarUsuario(@PathVariable Long id) { if (!usuarioRepository.existsById(id)) { return ResponseEntity.notFound().build(); } usuarioRepository.deleteById(id); return ResponseEntity.noContent().build(); }

Conclusão
Com esses métodos, sua API agora tem a capacidade de buscar, atualizar e deletar usuários de forma simples e eficaz.
Se você está começando no desenvolvimento de APIs em Java, essa é uma ótima maneira de entender como as operações CRUD funcionam em uma aplicação Spring Boot.

Sinta-se à vontade para compartilhar suas dúvidas e experiências nos comentários!
Até a próxima!

Criar uma API com Endpoints POST e GET de Forma Simples em Java + Springboot

ledilsonmenezes — Fri, 27 Sep 2024 21:02:18 +0000

Introdução

Hoje, vou mostrar como é fácil desenvolver uma API em Java! Se você é iniciante, este guia passo a passo vai ajudá-lo a criar uma API com endpoints POST e GET.

O que é uma API?

Uma API (Interface de Programação de Aplicações) permite que diferentes sistemas se comuniquem. Uma API RESTful utiliza métodos HTTP, como GET, POST, PUT e DELETE, para manipular dados.

Por que usar um Endpoint POST e GET?

POST: Usado para enviar dados ao servidor e criar novos registros.
GET: Usado para recuperar dados do servidor.

Passo a Passo para Criar uma API com Endpoints POST e GET em Java

Configuração do Ambiente

Primeiro, certifique-se de ter o Java e o Maven instalados. Crie um novo projeto Spring Boot. Você pode usar o Spring Initializr para facilitar:

Acesse start.spring.io

Selecione as dependências: "H2 Database","Spring Web" e "Spring Data JPA".
Gere o projeto e extraia o ZIP.

Estrutura do Projeto

Depois de extrair o projeto, você verá uma estrutura padrão do Maven. No diretório src/main/java/com.api.demo, crie os pacotes chamado Entity,Repository e Controller.

Criando a Classe Modelo

Crie uma classe chamada Usuario:

package com.api.demo.Entity;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class Usuario {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long Id;
    private String nome;
    private int idade;

    public Long getId() {
        return Id;
    }

    public void setId(Long id) {
        Id = id;
    }

    public String getNome() {
        return nome;
    }

    public void setNome(String nome) {
        this.nome = nome;
    }

    public int getIdade() {
        return idade;
    }

    public void setIdade(int idade) {
        this.idade = idade;
    }
}

Criando o Repositório

Crie uma interface chamada UsuarioRepository:

package com.api.demo.repository;

import com.api.demo.Entity.Usuario;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UsuarioRepository extends JpaRepository<Usuario,  Long> {
}

Criando o Controlador

Crie uma classe chamada UsuarioController:

package com.api.demo.Controller;
import com.api.demo.Entity.Usuario;
import com.api.demo.repository.UsuarioRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/api/usuarios")
public class UsuarioController {

    @Autowired
    private UsuarioRepository usuarioRepository;

    @PostMapping
    public ResponseEntity<Usuario> criarUsuario (@RequestBody Usuario usuario){
        Usuario novoUsuario = usuarioRepository.save(usuario);
        return ResponseEntity.status(201).body(usuario);
    }
    @GetMapping
    public ResponseEntity<List<Usuario>>listarUsuarios(){
        List<Usuario> usuarios = usuarioRepository.findAll();
        return ResponseEntity.ok(usuarios);
    }
}

Configurando o Banco de Dados
No arquivo application.properties, configure o banco de dados. Para um banco em memória, adicione:

spring.datasource.url=jdbc:h2:mem:testdb
spring.h2.console.enabled=true
spring.jpa.hibernate.ddl-auto=create

Url do banco de dados H2 http://localhost:8080/h2-console

Testando os Endpoints

Inicie a aplicação. Você pode usar o Postman ou Insomnia para testar.

https://www.postman.com/

https://insomnia.rest/

Para o endpoint POST, envie uma requisição para
http://localhost:8080/api/usuarios com um corpo JSON:

{
    "nome": "João",
    "idade": 25
}

Para o endpoint GET, envie uma requisição para
http://localhost:8080/api/usuarios.
Você receberá uma lista de usuários no formato JSON.

Pronto! Você criou uma API simples em Java com endpoints POST e GET. Agora, você pode expandir essa API para adicionar mais funcionalidades. A prática leva à perfeição, então continue explorando!

Se você gostou deste guia, compartilhe suas experiências nos comentários ou me avise se precisar de mais dicas!

DEV Community: ledilsonmenezes

Criando uma API Simples em Java: Parte 2 - Endpoints PUT e DELETE

Criar uma API com Endpoints POST e GET de Forma Simples em Java + Springboot