Arquitetura de Software Nathan Geeksman

Arquitetura hexagonal: separando núcleo de negócio da infraestrutura

Arquitetura hexagonal: separando núcleo de negócio da infraestrutura

Arquitetura hexagonal: separando núcleo de negócio da infraestrutura

Introdução

A arquitetura hexagonal, também conhecida como Ports e Adaptações ou Hexagonal Architecture, é uma abordagem de design de software que visa separar claramente o núcleo de negócios do sistema dos componentes de infraestrutura. Este tema é altamente relevante no contexto atual de desenvolvimento de software, pois a complexidade crescente das soluções e a necessidade de flexibilidade para atender às mudanças nos requisitos de negócios tornam essencial uma arquitetura que permita facilidades de manutenção, escalabilidade e adaptabilidade.

Com a grande quantidade de tecnologias emergentes e a evolução contínua das necessidades dos usuários, os sistemas de software precisam ser mais resilientes e capazes de se adaptar rapidamente às mudanças. A arquitetura hexagonal oferece uma estrutura para que os desenvolvedores possam criar soluções flexíveis e escaláveis, reduzindo a dependência do framework ou tecnologia específica.

Neste artigo, você aprenderá sobre as principais características da arquitetura hexagonal, como ela é implementada em prática e quais são suas vantagens em relação à desenvolvimento de software tradicional. Compreender e aplicar essas conceitos pode ser uma ferramenta valiosa para criar sistemas mais robustos, escaláveis e preparados para as mudanças do mercado.

O que é e por que importa

A Arquitetura Hexagonal é uma abordagem de design de software que visa separar claramente os componentes de núcleo de negócios do sistema dos componentes de infraestrutura, eliminando a dependência entre eles. Esta arquitetura é baseada em dois conceitos principais: Ports e Adaptações.

Os Ports são interfaces definidas pelo núcleo de negócios, que descrevem como as funcionalidades devem ser acessadas pelos usuários ou outros sistemas. Já as Adaptações são implementações específicas dessas interfaces, responsáveis por traduzir a abstração do núcleo de negócios em um formato compreendido pela infraestrutura.

A principal motivação para adotar a Arquitetura Hexagonal é reduzir a acoplamento entre os componentes do sistema. Com essa separação, o núcleo de negócios pode ser desenvolvido e testado independentemente da infraestrutura, facilitando a manutenção, a escalabilidade e a adaptação às mudanças nos requisitos de negócios.

A Arquitetura Hexagonal resolve problemas como:

  • Tight Coupling: A dependência entre os componentes do sistema pode levar à um acoplamento forte, dificultando a manutenção e a evolução do sistema.
  • Infraestrutura Tied to Business Logic: Quando o núcleo de negócios está estreitamente acoplado à infraestrutura, é difícil mudar ou substituir tecnologias sem afetar a lógica de negócios.

Ao adotar a Arquitetura Hexagonal, os desenvolvedores podem criar soluções mais flexíveis e escaláveis, reduzindo a dependência do framework ou tecnologia específica. Isso permite que o sistema seja mais fácilmente adaptado às mudanças nos requisitos de negócios, tornando-o mais resiliente e capaz de se manter atualizado ao longo do tempo.

Como funciona na prática

A Arquitetura Hexagonal pode ser compreendida como um processo de desenvolvimento em camadas, onde cada camada tem uma responsabilidade específica e é independente das outras.

Desenvolvendo as Interfaces (Ports)

  • Defina os ports do núcleo de negócios, descrevendo como as funcionalidades devem ser acessadas pelos usuários ou outros sistemas.
  • Isso pode incluir interfaces para autenticação, autorização, transações financeiras, etc.

Implementando as Adaptações

  • Desenvolva as adaptações que traduzirão a abstração do núcleo de negócios em um formato compreendido pela infraestrutura.
  • Isso pode incluir implementações específicas para bancos de dados, sistemas de gerenciamento de mensagens, etc.

Composição das Interfaces e Adaptações

  • O núcleo de negócios é composto pelas interfaces (ports) que descrevem as funcionalidades.
  • As adaptações são compostas por implementações específicas das interfaces, responsáveis por traduzir a abstração do núcleo de negócios em um formato compreendido pela infraestrutura.

Exemplo de Implementação

Um exemplo de implementação pode ser ilustrado com o seguinte diagrama:

  • Núcleo de Negócios: Define as interfaces (ports) que descrevem as funcionalidades, como autenticação e autorização.
  • Adaptações:

+ Banco de Dados: Implementação específica da interface de autenticação, responsável por verificar os dados do usuário no banco de dados.

+ Sistema de Mensagens: Implementação específica da interface de autorização, responsável por verificar as permissões do usuário e enviar uma resposta ao sistema de mensagens.

Com essa separação, o núcleo de negócios pode ser desenvolvido e testado independentemente da infraestrutura, facilitando a manutenção, a escalabilidade e a adaptação às mudanças nos requisitos de negócios.

Exemplo real

Vamos considerar um exemplo de uma aplicação de gerenciamento de estoque, que deve realizar as seguintes funcionalidades:

  • Realizar pedidos de compra e venda
  • Controlar a quantidade em estoque
  • Realizar relatórios de estoque

Nesse caso, o núcleo de negócios seria responsável por definir as interfaces (ports) que descrevem essas funcionalidades. As adaptações seriam implementadas para traduzir essa abstração em um formato compreendido pela infraestrutura.

// Exemplo de código em Java

public interface PedidosPort {
    void realizarPedidoComprado(Pedido pedido);
    void realizarPedidoVendido(Pedido pedido);
}

public class BancoDeDadosAdapter implements PedidosPort {
    @Override
    public void realizarPedidoComprado(Pedido pedido) {
        // Implementação para inserir o pedido no banco de dados
        System.out.println("Pedido de compra realizado com sucesso!");
    }

    @Override
    public void realizarPedidoVendido(Pedido pedido) {
        // Implementação para verificar a quantidade em estoque e atualizar o banco de dados
        System.out.println("Pedido de venda realizado com sucesso!");
    }
}

public class RelatoriosAdapter implements RelatoriosPort {
    @Override
    public void gerarRelatorioEstoque() {
        // Implementação para realizar a consulta no banco de dados e imprimir o relatório
        System.out.println("Relatório de estoque gerado com sucesso!");
    }
}

Nesse exemplo, as interfaces PedidosPort e RelatoriosPort definem as funcionalidades do núcleo de negócios. As adaptações implementadas para o banco de dados e os relatórios traduzem a abstração em um formato compreendido pela infraestrutura. Essa separação permite que o núcleo de negócios seja desenvolvido e testado independentemente da infraestrutura, facilitando a manutenção, a escalabilidade e a adaptação às mudanças nos requisitos de negócios.

Boas práticas e armadilhas comuns

Boas práticas

Use interfaces puras para definir a API de portas

As interfaces PedidosPort e RelatoriosPort devem ser usadas como contratos para as adaptações, garantindo que elas sejam independentes do implementador específico.

Mantenha a autenticidade da porta

Cada porta deve ter um único responsável por ela, evitando uma dependência forte entre as diferentes partes da aplicação.

Use fábricas de portas para controlar o ciclo de vida das instâncias de porta

Use fábricas para criar e gerenciar a existência das portas, facilitando a manutenção e testes dos componentes do núcleo de negócios.

Considere usar injeção de dependências para fornecer as portas às classes que necessitam delas

Essa abordagem permite uma maior flexibilidade e desacoplagem entre os módulos da aplicação, facilitando a mudança nos requisitos de negócios.

Armadilhas comuns

Confusão entre a porta e o implementador dela

Certifique-se de que as classes de porta são apenas interfaces ou abstrações, sem implementações concretas. Isso evita que a porta se torne um "implementador" em si mesma.

Falsas dependências entre os componentes do núcleo de negócios e infraestrutura

Verifique se as classes que implementam as portas não possuem vínculos fortes com a infraestrutura subjacente. Isso pode levar à dificuldade na manutenção e escalabilidade da aplicação.

Falta de isolamento entre as portas

Certifique-se de que cada porta é independente, sem dependências cruzadas ou comunicação direta entre elas. Isso facilita a testagem e manutenção das classes do núcleo de negócios.

Conclusão

A arquitetura hexagonal é uma abordagem eficaz para separar o núcleo de negócios da infraestrutura, promovendo flexibilidade e manutenabilidade na aplicação.

Ao adotar essa arquitetura, é importante evitar a confusão entre porta e implementador dela, garantir que as classes do núcleo de negócios não tenham dependências fortes com a infraestrutura subjacente e manter o isolamento entre as portas.

Com esses princípios em mente, você pode criar uma aplicação mais escalável e fácil de manter. Para aprofundar conhecimentos relacionados, é recomendável estudar sobre injeção de dependências, fábricas de porta e padrões de projeto que auxiliem na implementação da arquitetura hexagonal.

Além disso, a aplicação das práticas mencionadas ajudará a facilitar a evolução da aplicação ao longo do tempo, desde que os princípios sejam mantidos em todos os níveis da aplicação.

Referências