API Gateway para microsserviços em Java: guia completo com código

Introdução: por que seu projeto precisa de um API Gateway?

Imagine que você é um arquiteto projetando um edifício moderno. Em vez de criar uma centena de portas separadas para cada cômodo, você faz uma única entrada central com recepção, segurança e navegação. É exatamente assim que funciona um API Gateway para serviços Java — um ponto único de entrada para sua arquitetura de microsserviços.

Quando comecei a trabalhar com microsserviços em Java, a primeira coisa que enfrentei foi o caos. Os clientes acessavam diretamente dezenas de serviços, cada um com sua própria porta, autorização e formato de erros. Era como tentar reger uma orquestra onde cada músico toca sua parte sem ouvir o maestro. A solução veio exatamente na forma de um gateway de API Java.

Neste artigo, não vamos apenas falar de teoria. Vamos analisar exemplos reais, escrever código em Java usando o Spring Cloud Gateway, e você poderá aplicar esses conhecimentos imediatamente no seu projeto. Pronto para transformar o caos em ordem? Vamos nessa.

O que é um API Gateway e para que serve?

API Gateway (gateway de API) é uma camada intermediária entre os clientes (aplicações web, aplicativos móveis, serviços externos) e seus microsserviços internos. Ele assume todo o "trabalho pesado": roteamento, autenticação, balanceamento, cache e monitoramento.

No ecossistema Java, o mais utilizado para isso é o Spring Cloud Gateway — um gateway reativo baseado no Spring WebFlux, que é incrivelmente rápido e flexível.

Principais funções de um API Gateway em microsserviços Java:

• Ponto único de entrada — todas as requisições passam por um único host:porta
• Roteamento — redirecionamento de requisições para os serviços corretos
• Balanceamento de carga — distribuição de tráfego entre instâncias
• Segurança — verificação de tokens JWT, chaves de API
• Agregação de respostas — combinação de dados de vários serviços
• Rate limiting — limitação da frequência de requisições

Sem um API Gateway, sua arquitetura se parece com código espaguete: cada cliente conhece cada serviço. Com ele, você obtém um sistema limpo e gerenciável.

Criando um API Gateway em Java com Spring Cloud Gateway

Vamos passar da teoria à prática. Vou mostrar como montar um API Gateway para serviços Java funcional em apenas 15 minutos.

Passo 1: Dependências e configuração do projeto

Crie um novo projeto Spring Boot (recomendo a versão 3.x) e adicione as seguintes dependências no pom.xml:

<dependency>    <groupId>org.springframework.cloud</groupId>    <artifactId>spring-cloud-starter-gateway</artifactId></dependency>

<!-- Para registro no Service Discovery (opcional) --><dependency>    <groupId>org.springframework.cloud</groupId>    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId></dependency>

Não se esqueça de adicionar o BOM do Spring Cloud no <dependencyManagement>:

<dependencyManagement>    <dependencies>        <dependency>            <groupId>org.springframework.cloud</groupId>            <artifactId>spring-cloud-dependencies</artifactId>            <version>2023.0.1</version>            <type>pom</type>            <scope>import</scope>        </dependency>    </dependencies></dependencyManagement>

Passo 2: Configuração de rotas via YAML

A maneira mais simples de configurar o roteamento de requisições Java é através do application.yml. Aqui está um exemplo que redireciona requisições para os serviços de usuários e