DDD~领域事件应用篇(订单处理变得更清晰)
上一讲主要说了领域事件和领域总线，这并不是一个很容易理解的文章，所以本讲实例篇主要是为了补充上一讲的理论知识，本讲实例关注的是实际中的订单处理模块，我们知道，订单处理是电子商务的核心，往往在这里面，会有很多逻辑，在开发时，给我们带来了不少的难度，如何更好的分离关注点，是本讲的主题；本讲主要是修改订单状态后，为用户发通知为例，来以此更好的说一下领域事件在实际中的作用。
前言 领域事件使用的设计模式是发布/订阅模式，或者叫观察者模式。
一 订单的几种状态，在订单进入到其中一些状态时，需要通知用户
public enum OrderStatus { /// <summary> /// 表示销售订单的已创建状态 - 表明销售订单已被创建（未用）。 /// </summary> [Description("用户下单")] Created = 0, /// <summary> /// 订单被用户取消 /// </summary> [Description("取消订单")] Canceled, /// <summary> /// 表示销售订单的已付款状态 - 表明客户已向销售订单付款。 /// </summary> [Description("用户付款")] Paid, /// <summary> /// 表示销售订单的已发货状态。 /// </summary> [Description("已经发货")] Dispatched, /// <summary> /// 订单已经完成 /// </summary> [Description("订单完成")] Finished, }
二 为需要通知的状态，创建领域事件数据源(原来在.net事件里，它一般是EventArgs对象)
/// <summary> /// 订单已经确认事件源 /// </summary> public class Order_Confirm_Event : Project.Events.EventBase { public int OrderId { get; set; } public string UserName { get; set; } }
/// <summary> /// 订单已经付款事件缘 /// </summary> public class Order_Paid_Event : Project.Events.EventBase { public int OrderId { get; set; } public string UserName { get; set; } public decimal TotalPrice { get; set; } }
/// <summary> /// 订单已经发货事件源 /// </summary> public class Order_Dispatch_Event : Project.Events.EventBase { public int OrderId { get; set; } public string UserName { get; set; } }
三 为这些事件源添加事件处理方式
我们一般理解为“行为”，一种事件源可以有多种事件行为，如一个订单付款事件源，它可以同时有电子邮件行为和短信行为；反之，一个事件处理方式也可以对应多个事件源，如一个电子邮件行为，它可以同时对应订单付款
和订单发货等事件源，所以，领域事件在项目中是非常灵活的。
/// <summary> /// 发Email的事件处理方式 /// 调用方法：EventBus.Instance.Subscribe<User_Depts_Event>(new SendEmailEventHandler()) /// EventBus.Instance.Subscribe<User_Roles_Event>(new SendEmailEventHandler()) /// </summary> public class SendEmail_EventHandler : IEventHandler<Order_Confirm_Event>, IEventHandler<Order_Dispatch_Event>, IEventHandler<Order_Paid_Event> { static string prefix = "本消息来自电子邮件"; #region IEventHandler<Order_Confirm_Event> 成员 public void Handle(Order_Confirm_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经确认，订单号{1}，请尽快付款！({2})[{3}]" , evt.UserName , evt.OrderId , evt.EventDate , prefix)); } #endregion #region IEventHandler<Order_Dispatch_Event> 成员 public void Handle(Order_Dispatch_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经发货，订单号{1}，请注意查收！({2})[{3}]" , evt.UserName , evt.OrderId , evt.EventDate , prefix)); } #endregion #region IEventHandler<Order_Paid_Event> 成员 public void Handle(Order_Paid_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经成功付款，订单号{1}，付款金额为{2}元，我们会尽快安排发货！({3})[{4}]" , evt.UserName , evt.OrderId , evt.TotalPrice , evt.EventDate , prefix)); } #endregion }
/// <summary> /// 发短信的事件处理方式 /// </summary> public class SendSMS_EventHandler : IEventHandler<Order_Confirm_Event>, IEventHandler<Order_Dispatch_Event>, IEventHandler<Order_Paid_Event> { static string prefix = "本消息来自短信"; #region IEventHandler<Order_Confirm_Event> 成员 public void Handle(Order_Confirm_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经确认，订单号{1}，请尽快付款！({2})[{3}]" , evt.UserName , evt.OrderId , evt.EventDate , prefix)); } #endregion #region IEventHandler<Order_Dispatch_Event> 成员 public void Handle(Order_Dispatch_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经发货，订单号{1}，请注意查收！({2})[{3}]" , evt.UserName , evt.OrderId , evt.EventDate , prefix)); } #endregion #region IEventHandler<Order_Paid_Event> 成员 public void Handle(Order_Paid_Event evt) { Logger.Core.LoggerFactory.Instance.Logger_Info(string.Format("尊敬的客户{0}，你的订单已经成功付款，订单号{1}，付款金额为{2}元，我们会尽快安排发货！({3})[{4}]" , evt.UserName , evt.OrderId , evt.TotalPrice , evt.EventDate , prefix)); } #endregion }
四 订阅领域事件
我们需要有一个入口来订阅领域事件，如订阅订单确认事件，订单付款事件等，简单的做法是在global里统一注册，而标准合理的作法，我觉得应该在订单controller的静态构造方法里去注册它，因为只有用户操作订单相关模块时，才可能触
发订单这些事件！
/// <summary> /// 类的构造方法，处理与具体实例无法的东西 /// </summary> static OrderController() { #region 订阅相关领域事件 #region 订阅发email处理方式 EventBus.Instance.Subscribe<Order_Confirm_Event>(new SendEmail_EventHandler()); EventBus.Instance.Subscribe<Order_Dispatch_Event>(new SendEmail_EventHandler()); EventBus.Instance.Subscribe<Order_Paid_Event>(new SendEmail_EventHandler()); #endregion #region 订阅发短信的处理方式 EventBus.Instance.Subscribe<Order_Confirm_Event>(new SendSMS_EventHandler()); EventBus.Instance.Subscribe<Order_Dispatch_Event>(new SendSMS_EventHandler()); EventBus.Instance.Subscribe<Order_Paid_Event>(new SendSMS_EventHandler()); #endregion #endregion }
我们看到了，每种订单事件源都被注册了电子邮件和短信两种事件处理方式，这在对应的事件被触发（发布，publish)之后，它们会被执行。
六 触发具体事件
具体的事件在具体的方法里，独立的去触发，一般它会在业务逻辑层完成
/// <summary> /// 用户下单:create /// </summary> /// <param name="entity"></param> public void DoOrder(Order_Info entity) { entity.OrderStatus = (int)OrderStatus.Created; _orderRepository.Insert(entity); entity.Order_Detail.ToList().ForEach(j => j.OrderId = entity.Id); _orderDetailRepository.Insert(entity.Order_Detail); EventBus.Instance.Publish(new Order_Confirm_Event { OrderId = entity.Id, UserName = entity.UserName }); } /// <summary> /// 订单付款:paid /// </summary> /// <param name="entity"></param> public void PaidOrder(Order_Info entity) { entity.OrderStatus = (int)OrderStatus.Paid; _orderRepository.Update(entity); EventBus.Instance.Publish(new Order_Paid_Event { OrderId = entity.Id, TotalPrice = entity.TotalPrice, UserName = entity.UserName }); } /// <summary> /// 订单发货:dispatch /// </summary> /// <param name="entity"></param> public void DispatchOrder(Order_Info entity) { entity.OrderStatus = (int)OrderStatus.Dispatched; _orderRepository.Update(entity); EventBus.Instance.Publish(new Order_Dispatch_Event { OrderId = entity.Id, UserName = entity.UserName }); }
八 最后，我们看一下处理处理页面和结果的截图
生成的日志
生成的日志内容，类似于用户上到的电子邮件或者短信的内容
怎么样，看完这个例子相信您对领域事件有了更清晰的认识了吧，呵呵！