Arquitetura Hexagonal em Java: Como Blindar sua Aplicação das Mudanças Externas

 


O conceito de Arquitetura Hexagonal foi proposto por Alistair Cockburn, ainda nos anos 90, em um artigo publicado na primeira wiki da internet, a WikiWikiWeb famosa por reunir conteúdos sobre Engenharia de Software.

Os objetivos dessa arquitetura se alinham bastante com os princípios da Arquitetura Limpa: promover reutilização de código, alta coesão, baixo acoplamento, independência tecnológica e testabilidade. Em resumo, é uma forma de construir sistemas preparados para mudanças e longevidade.

 

Dois Mundos Bem Separados

A Arquitetura Hexagonal propõe que as classes do sistema sejam divididas em dois grandes grupos:

  • Classes de Domínio: onde vive a lógica de negócio pura.

  • Classes de Infraestrutura: que lidam com tecnologias específicas, como bancos de dados, frameworks, APIs externas e interfaces de usuário.

A regra de ouro é simples: as classes de domínio nunca devem depender das classes de infraestrutura. Essa separação garante que a lógica central do sistema continue estável, mesmo quando mudamos tecnologias ao redor dela.

Imagine poder trocar seu banco de dados, a interface REST ou até adicionar uma versão mobile, sem precisar tocar nas regras de negócio. Essa é a promessa da Arquitetura Hexagonal.

 

O Papel Dos Adaptadores

Essa separação é mediada por adaptadores — componentes que conectam o mundo externo com o domínio usando o padrão de projeto Adapter. Eles transformam chamadas e dados externos em formatos que o domínio entende (e vice-versa).

Visualmente, costuma-se representar isso como dois hexágonos concêntricos:

  • No centro: as classes de domínio (ou de negócio).

  • Em volta: os adaptadores.

  • Fora dos hexágonos: as tecnologias e sistemas externos, como bancos de dados, frameworks e interfaces.

 

O Problema do Acoplamento

Na maioria das aplicações Java (especialmente com frameworks como Spring), é comum ver classes de negócio diretamente ligadas ao JPA, controllers REST e objetos da infraestrutura.

Isso traz alguns problemas:

  • Dificuldade para testar regras de negócio isoladamente.

  • Trocar o banco de dados ou protocolo (REST → gRPC) exige reescrever muita coisa.

  • Baixa coesão e alta complexidade em manutenção.

     

Conceitos Fundamentais da Arquitetura Hexagonal

A Arquitetura Hexagonal parte da ideia de que o núcleo do sistema deve ser imutável e puro. Isso é feito com três blocos principais:

1. Domínio (ou Core)

  • Contém entidades, serviços de negócio e casos de uso.

  • Não conhece nenhum framework.

2. Portas (Ports)

  • Interfaces que representam entradas (casos de uso) e saídas (repositórios, serviços externos).

  • São definidos no domínio, mas implementados fora dele.

3. Adaptadores (Adapters)

  • Implementam as portas.

  • Interagem com frameworks e tecnologia: controladores HTTP, JPA, APIs externas, etc.

     

Para ilustrar esses conceitos, você pode conferir um projeto real que desenvolvi seguindo a Arquitetura Hexagonal em Java. Veja o repositório no GitHub:


 https://github.com/GabrielFCarrijo/Hexagonal_Architecture

 

Vantagens Reais da Arquitetura Hexagonal

  • Testes fáceis: é possível testar toda lógica de negócio com mocks das portas.

  • Tecnologia plugável: pode trocar REST por gRPC, JPA por Mongo, com impacto mínimo.

  • Organização clara: responsabilidades bem definidas.

  • Escalabilidade técnica: múltiplas interfaces (ex: REST, CLI, mobile) usando o mesmo domínio.

 

 Com isso conseguimos ver que a Arquitetura Hexagonal é uma estratégia poderosa para quem quer escrever código limpo, testável e preparado para o futuro. Em Java, ela exige disciplina na separação de camadas e um bom entendimento de interfaces, mas os ganhos são enormes.



Gabriel Carrijo

Gabriel Carrijo

Back-end Developer Java | Spring Boot | Quarkus | Microservices | SQL & NOSQL | SOLID | Design Patterns


Comments

Post a Comment

Popular posts from this blog

Spring VS Micronaut VS Quarkus

Image
Spring Boot vs. Quarkus vs. Micronaut: Qual é o framework ideal para o seu projeto? Quando se trata de construir aplicativos web modernos em Java, desenvolvedores têm à disposição uma algumas variedade de frameworks. Entre as opções mais populares do momento estão Spring Boot, Quarkus e Micronaut. Esses três frameworks não apenas suportam a criação de APIs REST, microsserviços e sistemas escaláveis, mas também apresentam filosofias distintas e vantagens exclusivas. Vou passar pra vocês um pouco sobre cada um deles e em que momento seria interessante usa-los.    Spring Boot Spring Boot é o framework mais amplamente usado para construir aplicativos web baseados em Java. Ele simplifica a configuração e o desenvolvimento de aplicativos Spring eliminando a necessidade de configurações XML complexas e oferecendo configurações padrão para configurações comuns. O Spring Boot é bem adequado para construir aplicativos monolíticos e de microsserviços, e faz parte do ecossistema maior do ...
Read more

Spring + Redis: Como melhorar sua aplicação com caching

Image
  Ao tratar de microsserviços é comum que dado uma aplicação de disponibilidade ou desempenho seja necessário mais de uma instância dando vida a um cluster. Junto ao ambiente clusterizado vem problemas na implementação de cache local, já que cada uma das instâncias é um processo independente, e a memória não é compartilhada, ocasionando que o cache fique inconsistente entre uma instância e outra. Neste tipo de situação a estratégia de cache local não é suficiente, pois agora quando um dado é armazenado em cache por uma instância, a outra instância deverá ter acesso em sua próxima consulta. Então se faz necessário a utilização de um provedor de cache distribuído como o nosso querido Redis .   Redis é um banco de dados não relacional que armazena dados em memória, proporcionando acesso muito rapido. Ele é muito usado como cache distribuído, permitindo múltiplas conexões simultâneas. No entanto, integrar Redis diretamente no código pode gerar dependência, tornando a tro...
Read more

Java + Kafka, Como essa parceria fucniona ?

Image
    O que é kafka e como ele funciona ? Para entender a parceria entre Java e Kafka, primeiro precisamos compreender o que é o Apache Kafka e como ele opera, o Kafka é uma plataforma distribuída de streaming de eventos baseada no modelo PUB/SUB , o que significa que ele publica e consome mensagens de forma assíncrona. Seu funcionamento se baseia em tópicos, que atuam como canais de comunicação onde as mensagens são organizadas e distribuídas para os consumidores.   Agora que entendemos oque é o kafka vamos entender o ponto principal os tópicos, cada tópico no Kafka é responsável por armazenar mensagens e distribuí-las para os consumidores que estão interessados nesse conteúdo. Além disso, os tópicos podem ser divididos em partições, permitindo escalabilidade e processamento paralelo isso é o grande diferencial do kafka pros demais serviços de mensageria. Vou exemplificar como os tópicos funcionam: spring-topic-dukes-notification --> Este tópico pode ser utilizado para ...
Read more