Como escrever uma API REST em Java em 30 minutos: para iniciantes

Como escrever uma API REST em Java em 30 minutos: para iniciantes

Criar uma API REST é uma das habilidades essenciais do desenvolvedor moderno. Se você está começando a estudar Java e quer criar rapidamente seu primeiro serviço web, este guia é para você. Vamos percorrer o caminho desde a instalação das ferramentas até uma API funcional que pode ser testada no navegador ou no Postman. Todo o processo levará no máximo 30 minutos.

Neste artigo, usaremos o Spring Boot — o framework mais popular para criar aplicações web em Java. Ele cuida de toda a configuração rotineira, permitindo que você se concentre na lógica. Como resultado, você terá uma API simples para gerenciar uma lista de tarefas (Todo List).

O que é uma API REST e para que serve?

REST (Representational State Transfer) é um estilo arquitetural para construir serviços web. Uma API REST opera sobre o protocolo HTTP e usa métodos padrão:

• GET — obter dados
• POST — criar um novo registro
• PUT — atualizar um registro existente
• DELETE — excluir um registro

Os dados geralmente são transmitidos no formato JSON. APIs REST são usadas em toda parte: desde aplicativos móveis até arquiteturas de microsserviços. Dominando isso, você poderá criar o backend para qualquer cliente.

Passo 1: Preparação do ambiente

Para trabalhar, precisaremos de três coisas. Certifique-se de que estão instaladas no seu computador.

1.1. JDK (Java Development Kit)

Baixe e instale o JDK 17 ou superior do site oficial da Oracle ou use o OpenJDK. Verifique a instalação com o comando no terminal:

java -version

1.2. IntelliJ IDEA (Community Edition)

Este é um ambiente de desenvolvimento gratuito, ideal para Java. Baixe-o do site oficial.

1.3. Postman (opcional)

Ferramenta para testar APIs. Pode ser baixada em postman.com. No início, você pode usar apenas o navegador.

Passo 2: Criando o projeto Spring Boot

A maneira mais rápida é usar o Spring Initializr. É uma ferramenta web que gera um esqueleto do projeto.

1. Acesse start.spring.io.
2. Selecione: Project: Maven, Language: Java, Spring Boot: 3.x.x.
3. No campo Group, digite com.example; em Artifact, digite todoapi.
4. Clique em Add Dependencies e adicione Spring Web.
5. Clique em Generate — um arquivo ZIP com o projeto será baixado.
6. Descompacte o arquivo e abra a pasta no IntelliJ IDEA.

A estrutura do projeto será assim:

• src/main/java/com/example/todoapi/ — código principal
• src/main/resources/application.properties — configurações
• pom.xml — arquivo de build do Maven

Passo 3: Criando o modelo de dados e o controlador

Agora vamos escrever o código. Primeiro, criaremos um modelo simples — a classe TodoItem.

3.1. Classe do modelo

Crie uma nova classe Java no pacote com.example.todoapi com o nome TodoItem.java:

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // Construtor padrão    public TodoItem() {}

    // Construtor com parâmetros    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // Getters e Setters    public L