从0到1开发领域模型：shriek-fx 中聚合根与值对象的设计与实现

从0到1开发领域模型：shriek-fx 中聚合根与值对象的设计与实现

【免费下载链接】shriek-fxAn easy-to-use rapid development framework developed on the basis of.NET Core 2.0, following the constraints of domain Driven Design (DDD) specifications, combined with the CQRS architecture to provide the infrastructure for event-driven, event backtracking, responsiveness, and more. Let developers enjoy the true meaning of object-oriented design patterns brought by the aesthetic.项目地址: https://gitcode.com/gh_mirrors/sh/shriek-fx

shriek-fx 是一个基于.NET Core 2.0开发的易用型快速开发框架，遵循领域驱动设计（DDD）规范约束，结合CQRS架构提供事件驱动、事件回溯、响应式等基础设施。本文将详细介绍如何在 shriek-fx 中设计和实现聚合根与值对象，帮助开发者轻松构建符合DDD规范的领域模型。

理解聚合根：领域模型的核心

在领域驱动设计中，聚合根是领域模型的核心元素，它负责维护领域对象的一致性和完整性。shriek-fx 提供了AggregateRoot<TKey>抽象类，为开发者提供了实现聚合根的基础。

聚合根的基本结构

AggregateRoot<TKey>类位于 src/Shriek/Domains/AggregateRoot.cs，它实现了IAggregateRoot<TKey>接口，提供了以下核心功能：

• 唯一标识：通过AggregateId属性实现
• 版本控制：通过Version属性跟踪聚合根的版本
• 事件管理：通过Changes集合管理未提交的领域事件
• 相等性比较：基于AggregateId实现对象相等性判断

实现自定义聚合根

让我们以TodoAggregateRoot为例，看看如何在 shriek-fx 中实现一个具体的聚合根。该类位于 samples/Shriek.Samples/Aggregates/TodoAggregateRoot.cs。

public class TodoAggregateRoot : AggregateRoot<Guid>, IHandle<TodoCreatedEvent>, IHandle<TodoChangedEvent> { // 属性定义 public string Name { get; protected set; } public string Desception { get; protected set; } public DateTime FinishTime { get; protected set; } // 构造函数 public TodoAggregateRoot(Guid aggregateId) : base(aggregateId) { } // 工厂方法 public static TodoAggregateRoot Register(CreateTodoCommand command) { var root = new TodoAggregateRoot(command.AggregateId); root.Create(command); return root; } // 领域行为 public void Create(CreateTodoCommand command) { // 业务规则验证 if (command.FinishTime < DateTime.Now) throw new DomainException("结束时间不能早于当前时间"); // 应用领域事件 ApplyChange(new TodoCreatedEvent() { AggregateId = this.AggregateId, Name = command.Name, Desception = command.Desception, FinishTime = command.FinishTime }); } // 事件处理 public void Handle(TodoCreatedEvent e) { this.AggregateId = e.AggregateId; this.Name = e.Name; this.Desception = e.Desception; this.FinishTime = e.FinishTime; } }

在这个示例中，TodoAggregateRoot继承自AggregateRoot<Guid>，使用Guid作为聚合根的唯一标识类型。它包含了以下关键部分：

1. 私有构造函数：确保聚合根只能通过工厂方法创建
2. 工厂方法：Register方法负责创建聚合根实例并初始化
3. 领域行为：Create和Change方法实现业务逻辑，并通过ApplyChange方法发布领域事件
4. 事件处理：实现IHandle<T>接口，处理领域事件并更新聚合根状态

掌握值对象：领域模型的基本构建块

值对象是领域模型中的另一个重要概念，它用于描述领域中的属性，没有唯一标识，通常通过其属性值来判断相等性。shriek-fx 提供了ValueObject<T>抽象类，简化了值对象的实现。

值对象的基本结构

ValueObject<T>类位于 src/Shriek/Domains/ValueObject.cs，它提供了以下核心功能：

• 相等性比较：基于属性值实现对象相等性判断
• 哈希码计算：基于属性值生成哈希码

public abstract class ValueObject<T> where T : ValueObject<T> { public override bool Equals(object obj) { var valueObject = obj as T; return !ReferenceEquals(valueObject, null) && EqualsCore(valueObject); } protected abstract bool EqualsCore(T other); public override int GetHashCode() { return GetHashCodeCore(); } protected abstract int GetHashCodeCore(); public static bool operator ==(ValueObject<T> a, ValueObject<T> b) { // 实现相等性运算符 } public static bool operator !=(ValueObject<T> a, ValueObject<T> b) { // 实现不等性运算符 } }

实现自定义值对象

虽然 shriek-fx 示例中没有提供具体的值对象实现，但我们可以基于ValueObject<T>抽象类创建一个简单的地址值对象：

public class Address : ValueObject<Address> { public string Street { get; } public string City { get; } public string State { get; } public string ZipCode { get; } public Address(string street, string city, string state, string zipCode) { Street = street; City = city; State = state; ZipCode = zipCode; } protected override bool EqualsCore(Address other) { return Street == other.Street && City == other.City && State == other.State && ZipCode == other.ZipCode; } protected override int GetHashCodeCore() { return Street.GetHashCode() ^ City.GetHashCode() ^ State.GetHashCode() ^ ZipCode.GetHashCode(); } }

在这个示例中，Address类继承自ValueObject<Address>，并实现了EqualsCore和GetHashCodeCore方法，基于属性值进行相等性判断和哈希码计算。

聚合根与值对象的协同工作

在实际应用中，聚合根和值对象通常协同工作，共同构成完整的领域模型。聚合根作为聚合的入口点，负责维护聚合内所有对象的一致性，而值对象则用于描述聚合根的属性。

在聚合根中使用值对象

我们可以扩展TodoAggregateRoot，添加一个Address值对象属性：

public class TodoAggregateRoot : AggregateRoot<Guid>, IHandle<TodoCreatedEvent>, IHandle<TodoChangedEvent> { // 其他属性... public Address Location { get; protected set; } public void Create(CreateTodoCommand command) { // 业务规则验证 if (command.FinishTime < DateTime.Now) throw new DomainException("结束时间不能早于当前时间"); // 应用领域事件 ApplyChange(new TodoCreatedEvent() { AggregateId = this.AggregateId, Name = command.Name, Desception = command.Desception, FinishTime = command.FinishTime, Location = new Address(command.Street, command.City, command.State, command.ZipCode) }); } // 其他方法... }

聚合根的持久化

shriek-fx 提供了多种事件存储实现，用于持久化聚合根的状态。例如，samples/Shriek.Samples/Repositories/TodoRepository.cs 提供了TodoAggregateRoot的仓储实现：

public class TodoRepository : ITodoRepository { private readonly TodoDbContext context; public TodoRepository(TodoDbContext context) { this.context = context; } public bool Create(TodoAggregateRoot root) { var _root = context.Set<TodoAggregateRoot>().Add(root); return context.SaveChanges() > 0; } public bool Change(TodoAggregateRoot root) { var _root = this.context.Set<TodoAggregateRoot>().Update(root); return context.SaveChanges() > 0; } // 其他方法... }

总结：构建强大的领域模型

通过 shriek-fx 提供的AggregateRoot<TKey>和ValueObject<T>基类，开发者可以轻松实现符合 DDD 规范的领域模型。聚合根作为领域模型的核心，负责维护领域对象的一致性和完整性，而值对象则用于描述领域中的属性，没有唯一标识。

在实际开发中，我们应该：

1. 识别领域中的聚合根，确保每个聚合根都有明确的边界和职责
2. 使用值对象描述聚合根的属性，提高代码的可读性和可维护性
3. 通过领域事件实现聚合根之间的通信，构建松耦合的系统

通过合理设计和实现聚合根与值对象，我们可以构建出更加清晰、灵活和可维护的领域模型，充分发挥 DDD 的优势，提高软件的质量和开发效率。

官方文档：docs/ 聚合根源码：src/Shriek/Domains/AggregateRoot.cs 值对象源码：src/Shriek/Domains/ValueObject.cs 示例代码：samples/Shriek.Samples/Aggregates/TodoAggregateRoot.cs

【免费下载链接】shriek-fxAn easy-to-use rapid development framework developed on the basis of.NET Core 2.0, following the constraints of domain Driven Design (DDD) specifications, combined with the CQRS architecture to provide the infrastructure for event-driven, event backtracking, responsiveness, and more. Let developers enjoy the true meaning of object-oriented design patterns brought by the aesthetic.项目地址: https://gitcode.com/gh_mirrors/sh/shriek-fx