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
相关产品推荐
相关产品推荐

