文章目录
- 工程结构概览:定义应用分层及依赖关系
- 1.应用分层
- 2.定义Entity
- 3.仓储层
- 3.1 工作单元:事务管理
- 3.2 仓储层
- 4.领域事件
- 5.APIController最佳实践
工程结构概览:定义应用分层及依赖关系
1.应用分层
- 领域模型层
- 基础设施层 ⇒ 仓储
- 应用层 ⇒ Api、后台任务Job
- 共享层
总结
- 领域模型专注业务的设计,不依赖仓储等基础设施层
- 基础设施的仓储层仅负责领域模型的取出和存储
- 使用CQRS模式设计应用层
- Web Api是面向前端的交互的接口,避免依赖领域模型
- 将共享代码设计为共享包,使用私有Nuget仓库分发管理
2.定义Entity
要点总结
- 将领域模型字段的修改设置为私有
- 使用构造函数表示对象的创建
- 使用具有业务含义的动作来操作模型字段
- 领域模型负责对自己数据的处理
- 领域服务或命令处理者负责调用领域模型业务动作
3.仓储层
3.1 工作单元:事务管理
仓储层最重要的就是事务的管理,这里通过工作单元模式实现事务管理
工作单元特性
- 使用同一上下文
- 跟踪实体的状态
- 保障事务一致性
3.2 仓储层
仓储层接口TEntity必须继承Entity,并且必须实现聚合根,也就是仓储中储存的对象是一个聚合根对象,
public interface IRepository<TEntity> where TEntity : Entity,IAggregateRoot
{IUnitOfWork UnitOfWork {get;}TEntity Add(TEntity entity);TEntity Update(TEntity entity);
}public interface IRepository<TEntity,TKey>:IRepository<TEntity> where TEntity : Entity<TKey>,IAggregateRoot
{bool Delete(TKey id);TEntity Get(TKey id);
}
4.领域事件
- 领域事件的构造和添加都应该在领域模型的方法内完成,不应该被外界的代码调用创建,因为这些事件都是领域模型内部发生的
- 接受领域事件的处理应该定义在应用层
- 创建完领域模型并保存之后,领域事件的处理程序才触发
总结
1.由领域模型内部创建事件
2.由专有的领域事件处理类处理领域事件
3.根据实际情况来决定是否在同一事务中处理(如一致性、性能等因素)
5.APIController最佳实践
// 伪代码[HttpGet]
public Task<long> CreateOrder([FromBody]CreateOrderViewModel viewModel)
{var model = viewModel.ToModel();// 模型转换return await orderService.CreateOrder(model);// 业务代码调用
}// 服务中代码
class OrderService : IOrderService
{public long CreateOrder(CreateOrderMode model){var address = new Address("测试路","测试市区","123");var order = new Order("订单名称","客户名称",999,address);_orderRepository.Add(order);await _orderRepository.UnitOfWork.SaveEntitiesAsync(cancellationToken);return order.Id;}
}
上述代码,随着业务逻辑的复杂化,Controller就会越来越膨胀。而DD领域设计的理念中,更新倾向于把应用程序的每一层明确区分,层与层之间的界限应该是明确的,同时在实现上应该也是隔离的。因此控制器不应该负责处理领域模型,处理仓储这些动作,Controller应该负责与前端交互,主要责任应该是定义输入和输出,实现身份认证、授权等功能。因此上述代码不建议使用
推荐使用中间者模式,演示代码如下
// 这里不建议使用属性服务进行服务注册,因为当使用属性注入的时候,需要把属性设置为public,并且开放set,get方法,可能出现意外情况,这可能导致代码的维护不可控
IMediator _mediator;
public OrderController(IMediator mediator)
{_mediator = mediator;
}// 这里尽可能的定义异步的action,可以帮助提高应用程序的吞吐量
[HttpPost]
public async Task<long> CreateOrder([FromBody] CreateOrderCommans cmd)
{return await _mediator.Send(cmd,HttpContext.RequestAborted);
}
总结
- 负责用户的输入输出定义
- 负责身份认证和授权
- 与领域服务职责区分开,不承载业务逻辑