Como usar o Spring Boot para criar APIs REST?

Como usar o Spring Boot para criar APIs REST?

O Spring Boot é um dos frameworks mais populares para o desenvolvimento de APIs REST em Java, tornando o processo ágil e eficiente. Com ele, é possível criar APIs com configuração mínima e suporte para JSON, bancos de dados e segurança.

1. Criando um Projeto Spring Boot

A forma mais rápida de iniciar um projeto Spring Boot é utilizando o Spring Initializr:

1. Acesse Spring Initializr .
2. Escolha as seguintes configurações:
   • Java 17 ou superior
   • Spring Boot versão mais recente
   • Dependências:
     • Spring Web (para criar APIs REST)
     • Spring Boot DevTools (facilita o desenvolvimento)
     • Lombok (reduz código repetitivo)
3. Clique em Generate e importe o projeto na sua IDE.

2. Criando um Endpoint REST com Spring Boot

Dentro do diretório src/main/java/com/exemplo, crie um Controller:

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class MeuController {

    @GetMapping("/mensagem")
    public String obterMensagem() {
        return "API REST criada com sucesso usando Spring Boot!";
    }
}

Explicação:

• @RestController define que essa classe trata requisições HTTP.
• @RequestMapping("/api") define a URL base da API.
• @GetMapping("/mensagem") cria um endpoint acessível via GET.

3. Criando um Endpoint que Retorna JSON

Para retornar JSON em vez de texto puro, criamos uma classe modelo e um endpoint que retorna uma lista de objetos:

import java.util.List;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class ProdutoController {

    @GetMapping("/produtos")
    public List<Produto> listarProdutos() {
        return List.of(
            new Produto(1, "Notebook", 4500.00),
            new Produto(2, "Smartphone", 2200.00)
        );
    }
}

class Produto {
    private int id;
    private String nome;
    private double preco;

    public Produto(int id, String nome, double preco) {
        this.id = id;
        this.nome = nome;
        this.preco = preco;
    }

    public int getId() { return id; }
    public String getNome() { return nome; }
    public double getPreco() { return preco; }
}

Explicação:

• listarProdutos() retorna uma lista de produtos no formato JSON.
• O Spring Boot converte automaticamente a classe Produto para JSON.

4. Testando a API com Postman

1. Execute o projeto na IDE (Run as → Spring Boot App).
2. No navegador ou no Postman, acesse:
   • http://localhost:8080/api/mensagem → Retorna texto simples.
   • http://localhost:8080/api/produtos → Retorna uma lista de produtos em JSON.

5. Configurando a Porta do Servidor

Se quiser alterar a porta padrão (8080), edite o arquivo application.properties:

server.port=9090

Agora, a API rodará em http://localhost:9090.

Conclusão

Criar APIs REST com Spring Boot é extremamente simples. O framework gerencia requisições HTTP, serialização JSON e facilita a integração com bancos de dados. Para continuar aprendendo, explore conceitos como Spring Data JPA e autenticação com JWT.

Por que Spring Boot é a melhor escolha para desenvolver APIs REST em Java?

Spring Boot revolucionou o desenvolvimento de APIs REST em Java. Antes, era necessário configurar manualmente servidores, mapeamento de rotas e manipulação de JSON. Com a introdução do Spring Boot, esse processo foi simplificado, permitindo que desenvolvedores foquem na lógica da aplicação sem perder tempo com configurações complexas.

Algumas aplicações:

• Criação de microsserviços
• Desenvolvimento de APIs para aplicações web e mobile
• Integração com bancos de dados via Spring Data JPA
• Autenticação e segurança de APIs com Spring Security

Dicas para quem está começando

• Use o Spring Initializr para gerar projetos rapidamente
• Teste suas APIs no Postman antes de integrá-las ao front-end
• Estude Spring Data JPA para conectar sua API a um banco de dados
• Aprenda sobre autenticação com JWT para proteger suas APIs

Compartilhe este tutorial