~ / hub / Hexagonal / ports & adapters
4 out 2026conceitosguia prático

Hexagonal / ports & adapters

Isolar domínio.

Na arquitetura hexagonal (ports & adapters), o núcleo da aplicação define ports (interfaces) e os adapters as implementam. Assim, o domínio fica isolado e a infraestrutura é desacoplada do core: o núcleo não conhece HTTP, SQL nem filas.

Como funciona

  • Ports de entrada: os casos de uso que o mundo externo chama.
  • Ports de saída: o que o núcleo precisa de fora, como um repositório ou o envio de e-mail.
  • Adapters: um controller REST, uma implementação com Postgres, um dublê em memória para testes.

Exemplo

O caso de uso "criar pedido" depende de uma interface PedidoRepository. Em produção ela é implementada com banco de dados; nos testes, com uma versão em memória.

Limitações

Vale a pena quando há regra de negócio relevante. Em aplicações simples, as interfaces extras são custo sem muito retorno.

Relacionados: arquitetura hexagonal (visão resumida), Clean Architecture, anti-corruption layer.

DICA Explore o hub de conteúdo.

Quer aplicar no seu time?

Diagnóstico gratuito.

solicitar →