事件总线知多少(1)

源码路径:Github-EventBus
事件总线知多少(1)
事件总线知多少(2)html

1. 引言

事件总线这个概念对你来讲可能很陌生,但提到观察者(发布-订阅)模式,你也许就很熟悉。事件总线是对发布-订阅模式的一种实现。它是一种集中式事件处理机制,容许不一样的组件之间进行彼此通讯而又不须要相互依赖,达到一种解耦的目的。git

咱们来看看事件总线的处理流程:github

图1:EventBus流程

了解了事件总线的基本概念和处理流程,下面咱们就来分析下如何去实现事件总线。安全

2.回归本质

在动手实现事件总线以前,咱们仍是要追本溯源,探索一下事件的本质和发布订阅模式的实现机制。并发

2.1.事件的本质

咱们先来探讨一下事件的概念。都是读过书的,应该都还记得记叙文的六要素:时间、地点、人物、事件(原由、通过、结果)。app

咱们拿注册的案例,来解释一下。
用户输入用户名、邮箱、密码后,点击注册,输入无误校验经过后,注册成功并发送邮件给用户,要求用户进行邮箱验证激活。dom

这里面就涉及了两个主要事件:函数

  1. 注册事件:原由是用户点击了注册按钮,通过是输入校验,结果是是否注册成功。
  2. 发送邮件事件:原由是用户使用邮箱注册成功须要验证邮箱,通过是邮件发送,结果是邮件是否发送成功。

其实这六要素也适用于咱们程序中事件的处理过程。开发过WinForm程序的都知道,咱们在作UI设计的时候,从工具箱拖入一个注册按钮(btnRegister),双击它,VS就会自动帮咱们生成以下代码:工具

void btnRegister_Click(object sender, EventArgs e)
{
 // 事件的处理
}

其中object sender指代发出事件的对象,这里也就是button对象;EventArgs e 事件参数,能够理解为对事件的描述 ,它们能够统称为事件源。其中的代码逻辑,就是对事件的处理。咱们能够统称为事件处理this

说了这么多,无非是想透过现象看本质:事件是由事件源和事件处理组成

2.2. 发布订阅模式

定义对象间一种一对多的依赖关系,使得每当一个对象改变状态,则全部依赖于它的对象都会获得通知并被自动更新。 ——发布订阅模式

发布订阅模式主要有两个角色:

  • 发布方(Publisher):也称为被观察者,当状态改变时负责通知全部订阅者。
  • 订阅方(Subscriber):也称为观察者,订阅事件并对接收到的事件进行处理。

发布订阅模式有两种实现方式:

  • 简单的实现方式:由Publisher维护一个订阅者列表,当状态改变时循环遍历列表通知订阅者。
  • 委托的实现方式:由Publisher定义事件委托,Subscriber实现委托。

总的来讲,发布订阅模式中有两个关键字,通知和更新。
被观察者状态改变通知观察者作出相应更新。
解决的是当对象改变时须要通知其余对象作出相应改变的问题。

若是画一个图来表示这个流程的画,图形应该是这样的:

图2:发布订阅模式流程

3 实现发布订阅模式

相信经过上面的解释,对事件和发布订阅模式有了一个大概的印象。都说理论要与实践相结合,因此咱们仍是动动手指敲敲代码比较好。
我将以『观察者模式』来钓鱼这个例子为基础,经过重构的方式来完善一个更加通用的发布订阅模式。
先上代码:

/// <summary>
/// 鱼的品类枚举
/// </summary>
public enum FishType
{
    鲫鱼,
    鲤鱼,
    黑鱼,
    青鱼,
    草鱼,
    鲈鱼
}

钓鱼竿的实现:

/// <summary>
 ///     鱼竿(被观察者)
 /// </summary>
 public class FishingRod
 {
     public delegate void FishingHandler(FishType type); //声明委托
     public event FishingHandler FishingEvent; //声明事件

     public void ThrowHook(FishingMan man)
     {
         Console.WriteLine("开始下钩!");

         //用随机数模拟鱼咬钩,若随机数为偶数,则为鱼咬钩
         if (new Random().Next() % 2 == 0)
         {
             var type = (FishType) new Random().Next(0, 5);
             Console.WriteLine("铃铛:叮叮叮,鱼儿咬钩了");
             if (FishingEvent != null)
                 FishingEvent(type);
         }
     }
 }

垂钓者:

/// <summary>
///     垂钓者(观察者)
/// </summary>
public class FishingMan
{
    public FishingMan(string name)
    {
        Name = name;
    }

    public string Name { get; set; }
    public int FishCount { get; set; }

    /// <summary>
    /// 垂钓者天然要有鱼竿啊
    /// </summary>
    public FishingRod FishingRod { get; set; }

    public void Fishing()
    {
        this.FishingRod.ThrowHook(this);
    }

    public void Update(FishType type)
    {
        FishCount++;
        Console.WriteLine("{0}:钓到一条[{2}],已经钓到{1}条鱼了!", Name, FishCount, type);
    }
}

场景类也很简单:

//一、初始化鱼竿
var fishingRod = new FishingRod();

//二、声明垂钓者
var jeff = new FishingMan("圣杰");

//3.分配鱼竿
jeff.FishingRod = fishingRod;

//四、注册观察者
fishingRod.FishingEvent += jeff.Update;

//五、循环钓鱼
while (jeff.FishCount < 5)
{
    jeff.Fishing();
    Console.WriteLine("-------------------");
    //睡眠5s
    Thread.Sleep(5000);
}

代码很简单,相信你一看就明白。但很显然这个代码实现仅适用于当前这个钓鱼场景,假若有其余场景也想使用这个模式,咱们还须要从新定义委托,从新定义事件处理,岂不很累。本着”Don't repeat yourself“的原则,咱们要对其进行重构。

结合咱们对事件本质的探讨,事件是由事件源和事件处理组成。针对咱们上面的案例来讲,public delegate void FishingHandler(FishType type);这句代码就已经说明了事件源和事件处理。事件源就是FishType type,事件处理天然是注册到FishingHandler上面的委托实例。
问题找到了,很显然是咱们的事件源和事件处理不够抽象,因此不能通用,下面我们就来动手改造。

3.1. 提取事件源

事件源应该至少包含事件发生的时间和触发事件的对象。
咱们提取IEventData接口来封装事件源:

/// <summary>
/// 定义事件源接口,全部的事件源都要实现该接口
/// </summary>
public interface IEventData
{
    /// <summary>
    /// 事件发生的时间
    /// </summary>
    DateTime EventTime { get; set; }

    /// <summary>
    /// 触发事件的对象
    /// </summary>
    object EventSource { get; set; }
}

天然咱们应该给一个默认的实现EventData

/// <summary>
/// 事件源:描述事件信息,用于参数传递
/// </summary>
public class EventData : IEventData
{
    /// <summary>
    /// 事件发生的时间
    /// </summary>
    public DateTime EventTime { get; set; }

    /// <summary>
    /// 触发事件的对象
    /// </summary>
    public Object EventSource { get; set; }

    public EventData()
    {
        EventTime = DateTime.Now;
    }
}

针对Demo,扩展事件源以下:

public class FishingEventData : EventData
{
    public FishType FishType { get; set; }
    public FishingMan FisingMan { get; set; }
}

完成后,咱们就能够去把在FishingRod声明的委托参数类型改成FishingEventData类型了,即public delegate void FishingHandler(FishingEventData eventData); //声明委托
而后修改FishingManUpdate方法按委托定义的参数类型修改便可,代码我就不放了,你们自行脑补。

到这一步咱们就统一了事件源的定义方式。

3.2.提取事件处理器

事件源统一了,那事件处理也得加以限制。好比若是随意命名事件处理方法名,那在进行事件注册的时候还要去按照委托定义的参数类型去匹配,岂不麻烦。

咱们提取一个IEventHandler接口:

/// <summary>
 /// 定义事件处理器公共接口,全部的事件处理都要实现该接口
 /// </summary>
 public interface IEventHandler
 {
 }

事件处理要与事件源进行绑定,因此咱们再来定义一个泛型接口:

/// <summary>
 /// 泛型事件处理器接口
 /// </summary>
 /// <typeparam name="TEventData"></typeparam>
 public interface IEventHandler<TEventData> : IEventHandler where TEventData : IEventData
 {
     /// <summary>
     /// 事件处理器实现该方法来处理事件
     /// </summary>
     /// <param name="eventData"></param>
     void HandleEvent(TEventData eventData);
 }

你可能会纳闷,为何先定义了一个空接口?这里就留给本身思考吧。

至此咱们就完成了事件处理的抽象。咱们再继续去改造咱们的Demo。咱们让FishingMan实现IEventHandler接口,而后修改场景类中将fishingRod.FishingEvent += jeff.Update;改成fishingRod.FishingEvent += jeff.HandleEvent;便可。代码改动很简单,一样在此略去。

至此你可能以为咱们完成了对Demo的改造。但事实上呢,咱们还要弄清一个问题——若是这个FishingMan订阅的有其余的事件,咱们该如何处理?
聪颖如你,你立马想到了能够经过事件源来进行区分处理

public class FishingMan : IEventHandler<IEventData>
{
    //省略其余代码
    public void HandleEvent(IEventData eventData)
    {
        if (eventData is FishingEventData)
        {
            //do something
        }

        if(eventData is XxxEventData)
        {
            //do something else
        }
    }
}

至此,这个模式实现到这个地步基本已经能够通用了。

4. 实现事件总线

通用的发布订阅模式不是咱们的目的,咱们的目的是一个集中式的事件处理机制,且各个模块之间相互不产生依赖。那咱们如何作到呢?一样咱们仍是一步一步的进行分析改造。

4.1.分析问题

思考一下,每次为了实现这个模式,都要完成如下三步:

  1. 事件发布方定义事件委托
  2. 事件订阅方定义事件处理逻辑
  3. 显示的订阅事件

虽然只有三步,但这三步已经很繁琐了。并且事件发布方和事件订阅方还存在着依赖(体如今订阅者要显示的进行事件的注册和注销上)。并且当事件过多时,直接在订阅者中实现IEventHandler接口处理多个事件逻辑显然不太合适,违法单一职责原则。这里就暴露了三个问题:

  1. 如何精简步骤?
  2. 如何解除发布方与订阅方的依赖?
  3. 如何避免在订阅者中同时处理多个事件逻辑?

带着问题思考,咱们就会更接近真相。

想要精简步骤,那咱们须要寻找共性。共性就是事件的本质,也就是咱们针对事件源和事件处理提取出来的两个接口。

想要解除依赖,那就要在发布方和订阅方之间添加一个中介。

想要避免订阅者同时处理过多事件逻辑,那咱们就把事件逻辑的处理提取到订阅者外部。

思路有了,下面咱们就来实施吧。

4.2.解决问题

本着先易后难的思想,咱们下面就来解决以上问题。

4.2.1. 实现IEventHandler

咱们先解决上面的第三个问题:如何避免在订阅者中同时处理多个事件逻辑?

天然是针对不一样的事件源IEventData实现不一样的IEventHandler。改造后的钓鱼事件处理逻辑以下:

/// <summary>
/// 钓鱼事件处理
/// </summary>
public class FishingEventHandler : IEventHandler<FishingEventData>
{
    public void HandleEvent(FishingEventData eventData)
    {
        eventData.FishingMan.FishCount++;

        Console.WriteLine("{0}:钓到一条[{2}],已经钓到{1}条鱼了!",
            eventData.FishingMan.Name, eventData.FishingMan.FishCount, eventData.FishType);

    }
}

这时咱们就能够移除在FishingMan中实现的IEventHandler接口了。
而后将事件注册改成fishingRod.FishingEvent += new FishingEventHandler().HandleEvent;便可。

4.2.2. 统一注册事件

上一个问题的解决,有助于咱们解决第一个问题:如何精简流程?
为何呢,由于咱们是根据事件源定义相应的事件处理的。也就是咱们以前说的能够根据事件源来区分事件。
而后呢?反射,咱们能够经过反射来进行事件的统一注册。
FishingRod的构造函数中使用反射,统一注册实现了IEventHandler<FishingEventData>类型的实例方法HandleEvent

public FishingRod()
{
    Assembly assembly = Assembly.GetExecutingAssembly();

    foreach (var type in assembly.GetTypes())
    {
        if (typeof(IEventHandler).IsAssignableFrom(type))//判断当前类型是否实现了IEventHandler接口
        {
            Type handlerInterface = type.GetInterface("IEventHandler`1");//获取该类实现的泛型接口
            Type eventDataType = handlerInterface.GetGenericArguments()[0]; // 获取泛型接口指定的参数类型

            //若是参数类型是FishingEventData,则说明事件源匹配
            if (eventDataType.Equals(typeof(FishingEventData)))
            {
                //建立实例
                var handler = Activator.CreateInstance(type) as IEventHandler<FishingEventData>;
                //注册事件
                FishingEvent += handler.HandleEvent;
            }
        }
    }
}

这样,咱们就能够移出场景类中的显示注册代码fishingRod.FishingEvent += new FishingEventHandler().HandleEvent;

4.2.3. 解除依赖

如何解除依赖呢?其实答案就在本文的两张图上,仔细对比咱们能够很直观的看到,Event Bus就至关于一个介于Publisher和Subscriber中间的桥梁。它隔离了Publlisher和Subscriber之间的直接依赖,接管了全部事件的发布和订阅逻辑,并负责事件的中转。

Event Bus终于要粉墨登场了!!!
分析一下,若是EventBus要接管全部事件的发布和订阅,那它则须要有一个容器来记录事件源和事件处理。那又如何触发呢?有了事件源,咱们就天然能找到绑定的事件处理逻辑,经过反射触发。代码以下:

/// <summary>
/// 事件总线
/// </summary>
public class EventBus
{
    public static EventBus Default => new EventBus();

    /// <summary>
    /// 定义线程安全集合
    /// </summary>
    private readonly ConcurrentDictionary<Type, List<Type>> _eventAndHandlerMapping;

    public EventBus()
    {
        _eventAndHandlerMapping = new ConcurrentDictionary<Type, List<Type>>();
        MapEventToHandler();
    }

    /// <summary>
    ///经过反射,将事件源与事件处理绑定
    /// </summary>
    private void MapEventToHandler()
    {
        Assembly assembly = Assembly.GetEntryAssembly();
        foreach (var type in assembly.GetTypes())
        {
            if (typeof(IEventHandler).IsAssignableFrom(type))//判断当前类型是否实现了IEventHandler接口
            {
                Type handlerInterface = type.GetInterface("IEventHandler`1");//获取该类实现的泛型接口
                if (handlerInterface != null)
                {
                    Type eventDataType = handlerInterface.GetGenericArguments()[0]; // 获取泛型接口指定的参数类型

                    if (_eventAndHandlerMapping.ContainsKey(eventDataType))
                    {
                        List<Type> handlerTypes = _eventAndHandlerMapping[eventDataType];
                        handlerTypes.Add(type);
                        _eventAndHandlerMapping[eventDataType] = handlerTypes;
                    }
                    else
                    {
                        var handlerTypes = new List<Type> { type };
                        _eventAndHandlerMapping[eventDataType] = handlerTypes;
                    }
                }
            }
        }
    }

    /// <summary>
    /// 手动绑定事件源与事件处理
    /// </summary>
    /// <typeparam name="TEventData"></typeparam>
    /// <param name="eventHandler"></param>
    public void Register<TEventData>(Type eventHandler)
    {
        List<Type> handlerTypes = _eventAndHandlerMapping[typeof(TEventData)];
        if (!handlerTypes.Contains(eventHandler))
        {
            handlerTypes.Add(eventHandler);
            _eventAndHandlerMapping[typeof(TEventData)] = handlerTypes;
        }
    }

    /// <summary>
    /// 手动解除事件源与事件处理的绑定
    /// </summary>
    /// <typeparam name="TEventData"></typeparam>
    /// <param name="eventHandler"></param>
    public void UnRegister<TEventData>(Type eventHandler)
    {
        List<Type> handlerTypes = _eventAndHandlerMapping[typeof(TEventData)];
        if (handlerTypes.Contains(eventHandler))
        {
            handlerTypes.Remove(eventHandler);
            _eventAndHandlerMapping[typeof(TEventData)] = handlerTypes;
        }
    }

    /// <summary>
    /// 根据事件源触发绑定的事件处理
    /// </summary>
    /// <typeparam name="TEventData"></typeparam>
    /// <param name="eventData"></param>
    public void Trigger<TEventData>(TEventData eventData) where TEventData : IEventData
    {
        List<Type> handlers = _eventAndHandlerMapping[eventData.GetType()];

        if (handlers != null && handlers.Count > 0)
        {
            foreach (var handler in handlers)
            {
                MethodInfo methodInfo = handler.GetMethod("HandleEvent");
                if (methodInfo != null)
                {
                    object obj = Activator.CreateInstance(handler);
                    methodInfo.Invoke(obj, new object[] { eventData });
                }
            }
        }
    }
}

事件总线主要定义三个方法,注册、取消注册、事件触发。还有一点就是咱们在构造函数中经过反射去进行事件源和事件处理的绑定。
代码注释已经很清楚了,这里就不过多解释了。

下面咱们就来修改Demo,修改FishingRod的事件触发:

/// <summary>
/// 下钩
/// </summary>
public void ThrowHook(FishingMan man)
{
    Console.WriteLine("开始下钩!");

    //用随机数模拟鱼咬钩,若随机数为偶数,则为鱼咬钩
    if (new Random().Next() % 2 == 0)
    {
        var a = new Random(10).Next();
        var type = (FishType)new Random().Next(0, 5);
        Console.WriteLine("铃铛:叮叮叮,鱼儿咬钩了");
        if (FishingEvent != null)
        {
            var eventData = new FishingEventData() { FishType = type, FishingMan = man };
            //FishingEvent(eventData);//再也不须要经过事件委托触发
            EventBus.Default.Trigger<FishingEventData>(eventData);//直接经过事件总线触发便可
        }
    }
}

至此,事件总线的雏形已经造成!

5.事件总线的总结

经过上面一步一步的分析和实践,发现事件总线也不是什么高深的概念,只要咱们本身善于思考,勤于动手,也能实现本身的事件总线。
根据咱们的实现,大概总结出如下几条:

  1. 事件总线维护一个事件源与事件处理的映射字典;
  2. 经过单例模式,确保事件总线的惟一入口;
  3. 利用反射完成事件源与事件处理的初始化绑定;
  4. 提供统一的事件注册、取消注册和触发接口。

最后,以上事件总线的实现只是一个雏形,还有不少潜在的问题。有兴趣的不妨思考完善一下,我也会继续更新完善,尽情期待!


参考资料

ABP EventBus
DDD~领域事件与事件总线
DDD事件总线的实现

相关文章
相关标签/搜索