Tutorials Clean Architecture & DDD Mastery

Entities vs Value Objects: Managing identity and state

On this page

Identity and Equality

In the Domain Layer, we categorize our objects into two main types: Entities and Value Objects.

1. Entities (The Identity)

An Entity is something that has a unique ID (like a GUID or an EmployeeNumber). Even if all its other properties change, it's still the same object. A User is an Entity. If they change their name or email, they are still 'User ID 123'. Equality is checked by comparing IDs.

2. Value Objects (The State)

A Value Object has NO identity. It is defined solely by its values. Money, Address, and Color are Value Objects. If two Money objects both represent '$10 USD', they are equal. Value Objects should be **Immutable**. If you want to change an address, you don't 'update' the properties; you replace the entire object with a new one.

3. Architect Insight

Q: "Why use Value Objects instead of primitive strings/ints?"

Architect Answer: "Encapsulation. A primitive string doesn't know how to validate an Email. A EmailAddress Value Object does. By moving validation and logic INTO the Value Object, you prevent your Entities from becoming 'Anemic' (logic-less bags of data). It's the key to robust, self-validating domain models."

Questions on this lesson 0

Sign in to ask a question or upvote helpful answers.

No questions yet — be the first to ask!

Clean Architecture & DDD Mastery
Course syllabus
1. Architectural Patterns
2. Domain-Driven Design (DDD) Foundations
3. Advanced DDD Patterns
4. Implementing the Clean Layers
5. Patterns for Data & Logic
6. Enterprise Domain Challenges
7. Testing Clean Architecture
8. Real-World Case Study
Toolliyo Assistant
Ask about tutorials, ebooks, training, pricing, mentor services, and support. I use public site content only—not admin or internal tools.

care@toolliyo.com

Need callback? Share your details