value-object-pattern-applied

Refactor primitive obsession by identifying scattered primitive parameters and clusters, encapsulating them into Java Value Objects with built-in validation and clear domain meaning. This reduces inconsistency and improves code clarity within a single Bounded Context.

A Value Object in Domain-Driven Design is an immutable construct that encapsulates related domain concepts, enforces value-based equality, and performs side-effect-free operations. It replaces primitive data types to represent domain attributes accurately.

Implement immutability and value-based equality in Java records by designing intention-revealing interfaces and side-effect-free behavior. Java records natively enforce these constraints, allowing you to encapsulate domain values securely within a Bounded Context.

Use Value Objects instead of primitives when you detect hidden domain concepts, scattered validation logic, or parameter clusters. Encapsulating these primitives ensures consistent validation and enforces immutability across the domain model.

The best way to group parameter clusters is encapsulating them into a Value Object using Java records. This enforces side-effect-free operations and value-based equality, replacing ambiguous primitive clusters with intention-revealing domain concepts.