07. Objetos de valor

Este capítulo nasce das 30 questões publicadas sobre Objetos de valor. A leitura do acervo revelou 30 núcleos de conhecimento, aqui reorganizados como uma explicação progressiva: primeiro o vocabulário e o modelo mental, depois os mecanismos, as decisões de implementação, os limites e a forma de verificar o comportamento do sistema.

Depois de entender o fluxo de desenvolvimento, aprofundamos a modelagem do negócio. O DDD organiza conhecimento, linguagem, limites e regras para que o software represente o domínio com clareza. Este é o capítulo 7 de 20 da disciplina Domain-Driven Design (DDD). Ele retoma Entidades e utiliza essa base para avançar. Na sequência, estudaremos Agregados e invariantes.

O fio condutor

O desenvolvimento de software começa com um problema e avança por decisões que precisam permanecer compreensíveis e verificáveis. Requisitos orientam modelos; modelos orientam código e arquitetura; testes verificam comportamento; e a operação devolve informações para o próximo ciclo. Uma falha importante no início tende a se espalhar pelas etapas seguintes.

Neste capítulo, use Objetos de valor para acompanhar quatro perguntas: qual problema precisa ser resolvido, como o mecanismo funciona, que consequências a escolha produz e como o resultado será verificado. Essa sequência transforma termos técnicos em decisões que podem ser explicadas e testadas.

Parte 1 — Fundamentos e vocabulário

Começamos por Parte 1 — Fundamentos e vocabulário, pois essa base organiza os conceitos e exemplos que aparecerão no restante do capítulo.

Objeto de valor

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. Evans define objeto de valor como o elemento do modelo que descreve características das coisas: o que importa é O QUE ele representa, não QUAL instância está em uso. Quando alguém escreve o CEP 70040-010 em um formulário, qualquer instância com esses mesmos dígitos serve igualmente — não há um 'CEP original' a preservar. Isso contrasta com as entidades, cuja igualdade decorre de uma identidade que atravessa o tempo e as mudanças de estado, como um Cliente que continua sendo o mesmo após trocar de nome e de endereço. É justamente a ausência de identidade que autoriza compartilhar e copiar objetos de valor livremente. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Objeto de valor, acompanhe a execução desde a entrada até a saída e anote pré-condições, mudança de estado, custo e falhas possíveis. Assim o conceito deixa de ser um rótulo e passa a orientar decisões.

Use como teste da compreensão: No Domain-Driven Design, um objeto de valor é um elemento do modelo que descreve uma característica do domínio e é definido exclusivamente pelos seus atributos, não possuindo identidade conceitual que o distinga de outra instância com os mesmos atributos. Depois verifique a afirmação com execução controlada, teste automatizado, análise do contrato, medição ou documentação da versão correspondente. A evidência deve reproduzir a propriedade afirmada, inclusive nos casos de erro e de fronteira.

Igualdade de objetos de valor

A partir dessa distinção, o próximo elemento completa o fluxo. A igualdade de objetos de valor é estrutural: compara-se o conteúdo dos atributos, e não a referência de memória nem um identificador. É a mesma lógica das notas de dinheiro físico: duas cédulas de R$ 50 são intercambiáveis porque o que importa é o valor que carregam, não qual pedaço de papel está na mão. Na implementação, isso se traduz em sobrescrever a comparação de igualdade (e o hash correspondente) para considerar os atributos — em Java, equals/hashCode; em C#, os record types já fazem isso por padrão. O contraste com entidades é direto: dois clientes com nomes e endereços idênticos continuam sendo pessoas diferentes, porque a igualdade de entidades é por identidade. Observe como definição, mecanismo e efeito permanecem ligados.