DDD~领域事件应用篇(订单处理变得更清晰)

回到目录

上一讲主要说了领域事件和领域总线,这并不是一个很容易理解的文章,所以本讲实例篇主要是为了补充上一讲的理论知识,本讲实例关注的是实际中的订单处理模块,我们知道,订单处理是电子商务的核心,往往在这里面,会有很多逻辑,在开发时,给我们带来了不少的难度,如何更好的分离关注点,是本讲的主题;本讲主要是修改订单状态后,为用户发通知为例,来以此更好的说一下领域事件在实际中的作用。

前言 领域事件使用的设计模式是发布/订阅模式,或者叫观察者模式。

一 订单的几种状态,在订单进入到其中一些状态时,需要通知用户

  public enum OrderStatus
    {
        /// 
        /// 表示销售订单的已创建状态 - 表明销售订单已被创建(未用)。
        /// 
        [Description("用户下单")]
        Created = 0,
        /// 
        /// 订单被用户取消
        /// 
        [Description("取消订单")]
        Canceled,
        /// 
        /// 表示销售订单的已付款状态 - 表明客户已向销售订单付款。
        /// 
        [Description("用户付款")]
        Paid,
        /// 
        /// 表示销售订单的已发货状态。
        /// 
        [Description("已经发货")]
        Dispatched,
        /// 
        /// 订单已经完成
        /// 
        [Description("订单完成")]
        Finished,

    }

二 为需要通知的状态,创建领域事件数据源(原来在.net事件里,它一般是EventArgs对象)

    /// 
    /// 订单已经确认事件源
    /// 
    public class Order_Confirm_Event : Project.Events.EventBase
    {
        public int OrderId { get; set; }
        public string UserName { get; set; }
    }
    /// 
    /// 订单已经付款事件缘
    /// 
    public class Order_Paid_Event : Project.Events.EventBase
    {
        public int OrderId { get; set; }
        public string UserName { get; set; }
        public decimal TotalPrice { get; set; }
    }
    /// 
    /// 订单已经发货事件源
    /// 
    public class Order_Dispatch_Event : Project.Events.EventBase
    {
        public int OrderId { get; set; }
        public string UserName { get; set; }
    }

三 为这些事件源添加事件处理方式

我们一般理解为“行为”,一种事件源可以有多种事件行为,如一个订单付款事件源,它可以同时有电子邮件行为和短信行为;反之,一个事件处理方式也可以对应多个事件源,如一个电子邮件行为,它可以同时对应订单付款

和订单发货等事件源,所以,领域事件在项目中是非常灵活的。

    /// 
    /// 发Email的事件处理方式
    /// 调用方法:EventBus.Instance.Subscribe(new SendEmailEventHandler())
    ///      EventBus.Instance.Subscribe(new SendEmailEventHandler())
    /// 
    public class SendEmail_EventHandler :
       IEventHandler,
        IEventHandler,
        IEventHandler
    {
        static string prefix = "本消息来自电子邮件";

        #region IEventHandler 成员

        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 成员

        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 成员

        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
    }
    /// 
    /// 发短信的事件处理方式
    /// 
    public class SendSMS_EventHandler :
         IEventHandler,
         IEventHandler,
         IEventHandler
    {
        static string prefix = "本消息来自短信";

        #region IEventHandler 成员

        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 成员

        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 成员

        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的静态构造方法里去注册它,因为只有用户操作订单相关模块时,才可能触

发订单这些事件!

     /// 
        /// 类的构造方法,处理与具体实例无法的东西
        /// 
        static OrderController()
        {
            #region 订阅相关领域事件

            #region 订阅发email处理方式
            EventBus.Instance.Subscribe(new SendEmail_EventHandler());
            EventBus.Instance.Subscribe(new SendEmail_EventHandler());
            EventBus.Instance.Subscribe(new SendEmail_EventHandler());
            #endregion

            #region 订阅发短信的处理方式
            EventBus.Instance.Subscribe(new SendSMS_EventHandler());
            EventBus.Instance.Subscribe(new SendSMS_EventHandler());
            EventBus.Instance.Subscribe(new SendSMS_EventHandler());
            #endregion

            #endregion
        }

我们看到了,每种订单事件源都被注册了电子邮件和短信两种事件处理方式,这在对应的事件被触发(发布,publish)之后,它们会被执行。

六 触发具体事件

具体的事件在具体的方法里,独立的去触发,一般它会在业务逻辑层完成

     /// 
        /// 用户下单:create
        /// 
        /// 
        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 });
        }

        /// 
        /// 订单付款:paid
        /// 
        /// 
        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 });
        }

        /// 
        /// 订单发货:dispatch
        /// 
        /// 
        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 });
        }

八 最后,我们看一下处理处理页面和结果的截图

生成的日志

生成的日志内容,类似于用户上到的电子邮件或者短信的内容

怎么样,看完这个例子相信您对领域事件有了更清晰的认识了吧,呵呵!

回到目录

你可能感兴趣的:(DDD~领域事件应用篇(订单处理变得更清晰))