Arquitetura Hexagonal (Ports and Adapters)

Vamos falar um pouco aqui sobre Arquitetura Hexagonal, também conhecida como Ports and Adapters.

A proposta aqui é algo mais prático. Para mais detalhes, nada melhor que conferir o artigo do criador, Alistair Cockburn:

🔗 https://alistair.cockburn.us/hexagonal-architecture

A ideia central dessa arquitetura é separar domínio e infraestrutura de forma elegante.

🧱 Conceitos básicos

• Domínio no centro:
  A lógica de negócio fica no núcleo da aplicação. A ideia é que ela esteja livre de dependências externas — esse é um dos grandes motivos para adotar essa arquitetura.

• Ports:
  Interfaces que definem os pontos de entrada (in) e saída (out) da aplicação.

• Adapters:
  Implementações específicas que conectam os ports às tecnologias externas, como APIs REST, mensagerias, bancos de dados ou interfaces gráficas.

Essa separação promove um design mais limpo e facilita a manutenção e os testes da aplicação.

✅ Vantagens

• Isolamento do domínio: Regra de negócio independente

• Testabilidade: Fácil testar sem depender da infraestrutura

• Flexibilidade: Troca fácil de banco, API, UI etc

• Manutenção: Código mais limpo e organizado

• Evolução tecnológica: Adapta-se bem a novas tecnologias

⚠️ Desvantagens

• Complexidade inicial: Mais camadas, mais arquivos

• Overengineering: Pode ser exagerado para projetos simples

• Boilerplate: Muito código repetitivo

• Mais mocks: Testes unitários mais verbosos

• Integração com frameworks: Pode exigir ajustes para desacoplar

🧩 Exemplo de estrutura utilizando Java / Spring

customer-registration
└── src/main/java/br/com/emersonmendes/hexagonal
    ├── adapter
    │   ├── in
    │   │   ├── messaging
    │   │   │   └── CustomerConsumer.java
    │   │   └── web
    │   │       └── CustomerController.java
    │   └── out
    │       ├── client
    │       │   └── CustomerFeignClient.java (Interface)
    │       └── repository
    │       │   └── CustomerRepository.java (Interface)
    │       └── CustomerOutputAdapter.java
    ├── application
    │   ├── core
    │   │   ├── domain
    │   │   │   └── Customer.java
    │   │   └── usecase
    │   │       └── CustomerUseCase.java
    │   └── ports
    │       ├── in
    │       │   └── CustomerInputPort.java (Interface)
    │       └── out
    │           └── CustomerOutputPort.java (Interface)
    ├── config
    │   └── SecurityConfig.java
    └── Application.java
  

🔗 Repositório com a estrutura mais completa:
https://github.com/emersonmendes/hexagonal