<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Spring Boot na prática: sua primeira API Java em minutos

DA

6 min

Spring Boot na prática: sua primeira API Java em minutos

Em menos de 5 minutos você gera um projeto, inicia o Tomcat na porta 8080 e já tem um endpoint que devolve JSON com a lista ["Clean Code","Refactoring"].

Neste artigo

Spring Boot elimina a configuração pesada do Java para web: com poucos comandos você sobe uma API REST funcional, com servidor embutido e rotas mapeadas. Esta tutoria mostra o caminho mínimo do zero até o primeiro endpoint respondendo JSON.

Use o site start.spring.io para gerar o projeto com as dependências Spring Web e Spring Data, escreva um controller com anotações e rode a aplicação com um comando. O endpoint responde JSON em minutos. Antes de codar, revise os fundamentos para você entender tudo sobre uma API, porque o Spring Boot assume esse vocabulário.

O que o Spring Boot resolve para quem usa Java?

O Java tradicional exigia dezenas de arquivos de configuração e ajuste manual de servidor para expor uma página. O Spring Boot inverte isso: ele escolhe padrões sensatos, embute o servidor na aplicação e expõe configuração por propriedades. O resultado é um projeto Java que inicia com um comando e publica rotas HTTP com anotações, sem toque manual em servidor nenhum.

Criando o projeto em minutos

No start.spring.io, escolha Maven ou Gradle, a versão estável do Java e as dependências Spring Web e Spring Data JPA. O site gera um ZIP com estrutura pronta, teste de exemplo e o arquivo de build. Descompacte, abra na IDE e execute a classe principal: o log mostra o Tomcat subindo na porta 8080, pronto para receber requisições.

O primeiro endpoint com controller

O controller é a porta de entrada HTTP da aplicação, e uma classe com uma anotação já entrega a primeira rota:

@RestController
public class LivroController {

    @GetMapping("/livros")
    public List<String> listar() {
        return List.of("Clean Code", "Refactoring");
    }
}

A classe declara que responde HTTP, a anotação mapeia o caminho GET e o retorno vira JSON automaticamente pelo Jackson, que já vem na dependência web. Reinicie a aplicação, acesse localhost:8080/livros e a lista aparece. O próximo passo é trocar a lista fixa por um repositório JPA que grava em banco.

Camadas: controller, service e repository

API real separa três responsabilidades: o controller recebe a requisição e devolve resposta, o service concentra as regras de negócio e o repository fala com o banco. O Spring cria e liga essas instâncias por injeção de dependência, e você declara o que precisa no construtor. Essa separação evita o controller gigante que mistura HTTP, regra e SQL no mesmo arquivo.

💡 Dica: habilite o devtools nas dependências. Ele reinicia a aplicação a cada mudança de classe e encurta o ciclo de edição, teste e ajuste, que é o ritmo de trabalho desta tutoria inteira.

Do tutorial ao estudo estruturado

A API de livros cobre o primeiro dia. Depois dela, os caminhos naturais são validação de entrada, tratamento de exceção, autenticação e testes de integração com banco em memória. Quem precisa de trilha com certificado tem o bootcamp gratuito do Bradesco com trilha Java, e existe ainda o curso gratuito de Java para mulheres, que cobre da base ao backend.

Os erros que travam a primeira API em Spring

O mais frequente é confundir camadas: regra de negócio dentro do Controller, consulta dentro de loop e a entidade do banco exposta direto na resposta. Cada um desses atalhos funciona no primeiro teste e explode na primeira mudança de requisito. Manter Controller fino, Service com a regra e Repository com a persistência não é burocracia: é o que permite alterar o comportamento da API sem caçar efeito colateral em dez lugares.

O segundo erro é deixar log e tratamento de exceção para depois. Uma API sem log estruturado vira caixa-preta no primeiro erro 500 em produção, e a resposta de erro improvisada vaza detalhe interno para o cliente. Configure resposta de erro padronizada e observe a saída desde o primeiro endpoint. Quem ainda está consolidando a base de requisição, resposta e cliente encontra o mapa no guia de fundamentos de API.

Configuração em Spring é explicitamente por ambiente, e o Actuator expõe health e métricas prontos para produção. Perfil separado para dev, staging e prod evita o erro clássico de log debug explosivo em produção, e os endpoints de health alimentam o Kubernetes sem código extra. Essas duas convenções, profiles e Actuator, são o que torna o Spring amigável ao operador sem reinventar nada.

Como evoluir a API depois do primeiro CRUD

O CRUD encerra o tutorial, mas não o aprendizado. O próximo passo natural é a validação de entrada com Bean Validation, em que anotações nos campos do DTO declaram o que é obrigatório, o tamanho máximo e o formato esperado, e o framework responde 400 com a lista de violações. O segundo passo é persistência de verdade com Spring Data JPA, que transforma interface em consulta sem SQL manual para os casos comuns.

Depois vêm os testes de integração, que sobem o contexto da aplicação com banco em memória e exercitam a rota de ponta a ponta, incluindo serialização e status. Fechando o ciclo, a autenticação com Spring Security protege as rotas e completa o desenho que as vagas descrevem. Essa ordem, validar, persistir, testar e proteger, é a mesma que projetos de produção seguem, então cada etapa estudada aqui reaparece no trabalho real com os mesmos nomes e ferramentas.

Perguntas frequentes

Preciso dominar Java antes do Spring Boot?

Os fundamentos bastam: classes, coleções, exceções e interfaces. O Spring acrescenta conceitos próprios, como injeção de dependência e anotações, mas você aprende os dois em paralelo com prática.

Spring Boot é gratuito?

Sim, o framework é open source e as ferramentas principais não têm custo. Empresas pagam suporte comercial opcional para versões com garantia de longo prazo.

Qual a diferença entre Spring e Spring Boot?

Spring é o ecossistema de módulos; Spring Boot é a camada que configura tudo automaticamente e embute o servidor. Todo projeto novo começa direto pelo Spring Boot.

Quais bancos o Spring Data suporta?

Os principais relacionais, como PostgreSQL e MySQL, e NoSQL como MongoDB e Redis. A troca de banco normalmente muda configuração e dependência, e não o código das regras.

Como testar os endpoints?

Use o próprio Spring Boot Test com MockMvc para testar a camada web, ou ferramentas como Insomnia e Postman durante o desenvolvimento. Teste de integração com banco em memória cobre o fluxo completo.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 18/11/2026 •

Ver perfil do autor

COMPARTILHAR