You need to enable JavaScript to run this app. abp.io中聚合根创建时同步初始化子集合及业务校验最佳实践咨询
优惠活动
大模型
产品
解决方案
定价
更多

abp.io中聚合根创建时同步初始化子集合及业务校验最佳实践咨询

ABP.io 聚合根创建关联子集合与业务校验最佳实践

核心分层职责原则(ABP规范要求)

  • 应用层仅负责工作流编排、DTO参数的基础格式校验、入参转换、调用领域层逻辑,不实现任何业务规则
  • 领域层(领域服务+聚合根本身)负责所有业务规则校验、聚合根创建、子集合操作,领域层不能引用应用层的DTO类型

疑问逐一解答

1. 是否可以直接将RequestedItemsDTO对象传入Manager的CreateAsync方法?

不可以。领域层不允许依赖应用层的DTO类型,你需要在应用层先将CreateReservationItemInputDto集合转换为ReservationItem领域实体集合,再传递给领域服务方法。

2. 是否需要在应用服务遍历RequestedItems逐个传递给Manager处理?

不需要。应用层不实现业务逻辑,你可以把转换完成的ReservationItem集合整体传递给领域服务的CreateAsync方法,子项的添加逻辑统一封装在领域服务内部。

3. RequestedItems数量为0的业务异常应该在哪里抛出?

如果「预订必须包含至少一个商品」是业务规则,该校验必须放在领域层处理,优先放在聚合根构造函数中,其次可以放在领域服务的创建方法中,抛出ABP标准的BusinessException即可。

4. AddReservationItem方法的调用时机?

在领域服务的CreateAsync方法中,完成聚合根本体的创建后,遍历子项集合逐个调用该方法即可,因为方法是internal修饰,只要领域服务和聚合根在同一个程序集即可直接访问。

改造后代码示例

调整聚合根构造函数,内置子项校验逻辑

public class Reservation : FullAuditedAggregateRoot<Guid>
{
    public Enum.Status Status { get; private set; }
    public string ReserverNote { get; private set; }
    public ICollection<ReservationItem> ReservationItems { get; private set; } // 改为private set禁止外部直接修改集合
    public ICollection<OverduePayment> OverduePayments { get; private set; }

    private Reservation() { }

    internal Reservation(
        Guid id,
        Enum.Status status,
        [NotNull] string reserverNote,
        [NotNull] IEnumerable<ReservationItem> reservationItems // 新增子项参数
        ) : base(id)
    {
        ReserverNote = reserverNote;
        Status = status;

        ReservationItems = new Collection<ReservationItem>();
        OverduePayments = new Collection<OverduePayment>();
        
        // 内置业务规则校验
        if (!reservationItems.Any())
        {
            throw new BusinessException("Reservation:ItemsCannotBeEmpty")
                .WithMessage("预订至少需要选择一个商品");
        }
        
        // 内置子项添加逻辑,保证聚合一致性
        foreach (var item in reservationItems)
        {
            AddReservationItem(item);
        }
    }

    internal void AddReservationItem(ReservationItem reservationItem)
    {
        if (ReservationItems.Any(r => r.Id == reservationItem.Id))
        {
            return;
        }
        ReservationItems.Add(reservationItem);
    }
}

调整领域服务ReservationSystemManager的CreateAsync方法

public class ReservationSystemManager : DomainService
{
    public async Task<Reservation> CreateAsync(
        string reserverNote, 
        Enum.Status status,
        IEnumerable<ReservationItem> reservationItems)
    {
        // 这里可放置依赖其他领域服务的校验逻辑,比如校验用户是否有逾期未支付订单、校验商品库存等
        var reservationId = GuidGenerator.Create();
        var reservation = new Reservation(reservationId, status, reserverNote, reservationItems);
        return await Task.FromResult(reservation); // 无异步依赖可改为同步方法
    }
}

调整应用服务实现

public async Task<ReservationDto> CreateReservationAsync(CreateReservationInputDto input)
{
    // 应用层仅做DTO到领域实体的转换
    var reservationItems = ObjectMapper.Map<List<CreateReservationItemInputDto>, List<ReservationItem>>(input.RequestedItems);
    
    // 调用领域服务创建聚合根
    var reservation = await _reservationSystemManager.CreateAsync(
        input.ReserverNotes,
        input.Status,
        reservationItems
    );
    
    // 仓储保存聚合根
    await _reservationRepository.InsertAsync(reservation, autoSave: true);
    
    // 映射为DTO返回
    return ObjectMapper.Map<Reservation, ReservationDto>(reservation);
}

额外规范提示

  • DTO的基础校验(比如ReserverNotes长度限制、Status为合法枚举值)可以直接在CreateReservationInputDto上加数据注解或者用FluentValidation实现,由ABP框架自动触发校验
  • 所有修改聚合根状态的操作都应该通过聚合根提供的方法实现,不要直接修改聚合根的属性或集合内容,保证聚合的一致性

内容的提问来源于stack exchange,提问作者klevendoglu

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 13:45:04