EventFlow项目中的聚合根(Aggregate)深度解析-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00057/article/details/148863832

EventFlow项目中的聚合根(Aggregate)深度解析

EventFlow Async/await first CQRS+ES and DDD framework for .NET 项目地址: https://gitcode.com/gh_mirrors/ev/EventFlow

前言

在领域驱动设计(DDD)和事件溯源(Event Sourcing)架构中，聚合根(Aggregate Root)是最核心的概念之一。本文将深入探讨EventFlow框架中聚合根的实现机制和使用方法，帮助开发者更好地理解和应用这一重要概念。

聚合根基础概念

聚合根是DDD中的一种设计模式，它代表了一组相关对象的边界，是外部访问这些对象的唯一入口。在EventFlow中，聚合根不仅是领域模型的核心，还承担着事件溯源的重要职责。

创建聚合根身份标识

在EventFlow中创建聚合根之前，首先需要定义其身份标识。框架提供了两种方式：

直接实现IIdentity接口
继承Identity<>基类（推荐）

[JsonConverter(typeof(SingleValueObjectConverter))]
public class ProductId : Identity<ProductId>
{
  public ProductId(string value) : base(value)
  {
  }
}

这里有几个技术要点需要注意：

Identity<>是一个值对象(Value Object)，提供了ID生成和验证的通用功能
使用SingleValueObjectConverter可以使JSON序列化结果更简洁
身份标识是不可变的(Immutable)，一旦创建就不能修改

定义聚合根类

定义聚合根类非常简单，只需继承AggregateRoot<,>泛型类：

public class ProductAggregate : AggregateRoot<ProductAggregate, ProductId>
{
  public ProductAggregate(ProductId id) : base(id)
  {
  }
}

注意泛型参数：

第一个参数是聚合根本身类型
第二个参数是聚合根的身份标识类型

事件定义与处理

在事件溯源系统中，聚合的状态变化通过事件来记录。定义事件时需要继承AggregateEvent<,>：

public class ProductPriceChangedEvent : AggregateEvent<ProductAggregate, ProductId>
{
  public decimal NewPrice { get; }
  
  public ProductPriceChangedEvent(decimal newPrice)
  {
    NewPrice = newPrice;
  }
}

事件应用策略

EventFlow提供了四种事件应用策略，开发者可以根据需求选择：

IEmit接口实现（最简单）

public class ProductAggregate : 
  AggregateRoot<ProductAggregate, ProductId>,
  IEmit<ProductPriceChangedEvent>
{
  public void Apply(ProductPriceChangedEvent e)
  {
    // 状态变更逻辑
  }
}

状态对象（推荐复杂场景）

public class ProductState : AggregateState<ProductAggregate, ProductId>
{
  public void Apply(ProductPriceChangedEvent e)
  {
    // 状态变更逻辑
  }
}

注册特定事件处理器

public ProductAggregate(ProductId id) : base(id)
{
  Register<ProductPriceChangedEvent>(e => HandlePriceChange(e));
}

自定义事件应用器

修改聚合状态

在EventFlow中修改聚合状态必须通过事件来完成，这是事件溯源的核心原则。

基本修改流程

执行业务逻辑验证
通过Emit方法发布事件
在事件处理器中实际修改状态

public void ChangePrice(decimal newPrice)
{
  if(newPrice <= 0)
    throw DomainError.With("价格必须大于零");
    
  Emit(new ProductPriceChangedEvent(newPrice));
}

聚合持久化操作

EventFlow提供了多种方式来持久化聚合变更。

使用IAggregateStore

// 更新聚合的简便方式
await aggregateStore.UpdateAsync<ProductAggregate, ProductId>(
  productId,
  sourceId,
  (agg, ct) => 
  {
    agg.ChangePrice(99.99m);
    return Task.CompletedTask;
  },
  cancellationToken);

手动加载和保存

// 加载
var product = await aggregateStore.LoadAsync<ProductAggregate, ProductId>(
  productId, 
  cancellationToken);

// 修改
product.ChangePrice(99.99m);

// 保存
await aggregateStore.StoreAsync(
  product, 
  sourceId, 
  cancellationToken);

事件读取

EventFlow提供了IEventStore接口来读取聚合事件：

// 读取所有事件
var events = await eventStore.LoadEventsAsync<ProductAggregate, ProductId>(
  productId,
  cancellationToken);

// 读取范围事件
var rangeEvents = await eventStore.LoadEventsAsync<ProductAggregate, ProductId>(
  productId,
  fromSequenceNumber,
  toSequenceNumber,
  cancellationToken);