CodeWF.EventBus：轻量级事件总线，让通信更流畅

1. CodeWF.EventBus

EventBus(事件总线)，用于解耦模块之间的通讯。本库（CodeWF.EventBus）适用于进程内消息传递（无其他外部依赖），与大家普遍使用的MediatR通知功能类似，但MediatR库侧重于ASP.NET Core设计使用，本库优势：

1. 设计可在各种模板项目使用，如 WPF、Winform、Avalonia UI、ASP.NET Core 等。
2. 支持使用了 IOC 容器的项目，当然也支持未使用任何 IOC 容器的模板项目。
3. 参考MASA Framework增强消息处理能力：

[Event]
public class MessageHandler
{
    private readonly ITimeService timeService;

    public MessageHandler(ITimeService timeService)
    {
        this.timeService = timeService;
    }

    [EventHandler(Order = 3)]
    public void ReceiveAutoCreateProductMessage3(CreateProductMessage message)
    {
        AddLog($"MessageHandler Received message 3 \"{message}\"");
    }

    [EventHandler(Order = 1)]
    public void ReceiveAutoDeleteProductMessage(DeleteProductMessage message)
    {
        AddLog($"MessageHandler Received message \"{message}\"");
    }

    [EventHandler(Order = 2)]
    public void ReceiveAutoCreateProductMessage2(CreateProductMessage message)
    {
        AddLog($"MessageHandler Received message 2 \"{message}\"");
    }

    private void AddLog(string message)
    {
        Console.WriteLine($"{timeService.GetTime()}: {message}\r\n");
    }
}

2. 怎么使用事件总线？

首先请搜索 NuGet 包CodeWF.EventBus并安装，下面细说使用方法。

2.1. 添加事件总线

2.1.1. 使用了 IOC

如果是 ASP.NET Core 程序，比如 MVC、Razor Pages、Blazor Server 等，，在Program中添加如下代码：

// ....

// 1、注册事件总线，将标注`EventHandler`特性方法的类采用单例方式注入IOC容器
EventBusExtensions.AddEventBus(
    (t1, t2) => builder.Services.AddSingleton(t1, t2),
    t => builder.Services.AddSingleton(t),
    typeof(Program).Assembly);

var app = builder.Build();

// ...

// 2、将上面已经注入IOC容器的类取出、关联处理方法到事件总线管理
EventBusExtensions.UseEventBus((t) => app.Services.GetRequiredService(t), typeof(Program).Assembly);

// ...

• AddEventBus方法会扫描传入的程序集列表，将标注Event特性的类下又标注EventHandler特性方法的类采用单例方式注入 IOC 容器。
• UseEventBus方法会将上一步注入的类通过 IOC 单例获取到实例，将实例的消息处理方法注册到消息管理队列中去，待收到消息发布时，会从消息管理队列中查找消息处理方法并调用，达到消息通知的功能。

如果使用的其他 IOC，比如 WPF 中使用了 Prism 框架，写法如下：

protected override void RegisterTypes(IContainerRegistry containerRegistry)
{
    IContainer? container = containerRegistry.GetContainer();

    // ...

    // Register EventBus
    EventBusExtensions.AddEventBus(
        (t1,t2)=> containerRegistry.RegisterSingleton(t1,t2),
        t=> containerRegistry.RegisterSingleton(t),
        typeof(App).Assembly);

    // ...

    // Use EventBus
    EventBusExtensions.UseEventBus(t => container.Resolve(t), typeof(App).Assembly);
}

根据 IOC 注册单例、获取服务的 API 不同，做相应修改即可。

2.1.2. 未使用 IOC

未使用 IOC 容器，比如默认的 WPF、Winform、AvaloniaUI、控制台程序不包含 IOC 容器，不做事件服务注册操作，功能使用上和使用IOC只差自动订阅功能，其他功能一样。

2.2. 定义消息（事件类型）

消息即需要发布或订阅的事件类型，消息需要继承自CodeWF.EventBus.Message：

public class CreateProductMessage : CodeWF.EventBus.Message
{
    public string Name { get; }

    public CreateProductMessage(object sender, string name) : base(sender)
    {
        Name = name;
    }

    public override string ToString()
    {
        return $"Create product message ->Product name:{Name}";
    }
}

public class DeleteProductMessage : CodeWF.EventBus.Message
{
    public string Id { get; }

    public DeleteProductMessage(object sender, string id) : base(sender)
    {
        Id = id;
    }

    public override string ToString()
    {
        return $"Delete product message ->Product ID：{Id}";
    }
}

2.3. 订阅消息（事件）

2.3.1. 自动订阅

在B/S程序中，一般将事件处理程序单独封装到一个类中，如下代码：

[Event]
public class MessageHandler
{
    private readonly ITimeService timeService;

    public MessageHandler(ITimeService timeService)
    {
        this.timeService = timeService;
    }

    [EventHandler(Order = 3)]
    public void ReceiveAutoCreateProductMessage3(CreateProductMessage message)
    {
        AddLog($"MessageHandler Received message 3 \"{message}\"");
    }

    [EventHandler(Order = 1)]
    public void ReceiveAutoDeleteProductMessage(DeleteProductMessage message)
    {
        AddLog($"MessageHandler Received message \"{message}\"");
    }

    [EventHandler(Order = 2)]
    public void ReceiveAutoCreateProductMessage2(CreateProductMessage message)
    {
        AddLog($"MessageHandler Received message 2 \"{message}\"");
    }
}

• 类MessageHandler添加了Event特性，在 IOC 注入时标识为可以做为单例注入。
• 标注了EventHandler特性的方法拥有处理消息的能力，该方法只能有一个事件类型参数。

使用 IOC 容器的程序会自动将标注Event特性的类做为单例注入容器，事件总线收到消息通知时自动查找标注EventHandle特性的方法进行调用，达到消息通知的功能。

2.3.2. 手动订阅

对于未标注Event特性的类，可手动注册消息处理程序，如下图是未使用 IOC，手动注册示例：

internal class MessageHandler
{
    internal void ManuSubscribe()
    {
        Messenger.Default.Subscribe<CreateProductMessage>(this, ReceiveManuCreateProductMessage);
        Messenger.Default.Subscribe<DeleteProductMessage>(this, ReceiveManuDeleteProductMessage);
    }

    void ReceiveManuCreateProductMessage(CreateProductMessage message)
    {
        AddLog($"Received manually registered \"{message}\"");
    }

    void ReceiveManuDeleteProductMessage(DeleteProductMessage message)
    {
        AddLog($"Received manually registered \"{message}\"");
    }
}

上面挨个注册处理方法有时会过于啰嗦，可以简化：

internal class MessageHandler
{
    internal void AutoSubscribe()
    {
        Messenger.Default.Subscribe(this);
    }

    [EventHandler(Order = 3)]
    private void ReceiveAutoCreateProductMessage3(CreateProductMessage message)
    {
        AddLog($"Received automatic subscription message 3 \"({message}\"");
    }

    [EventHandler(Order = 1)]
    private void ReceiveAutoDeleteProductMessage(DeleteProductMessage message)
    {
        AddLog($"Received automatic subscription message \"{message}\"");
    }

    [EventHandler(Order = 2)]
    private void ReceiveAutoCreateProductMessage2(CreateProductMessage message)
    {
        AddLog($"Received automatic subscription message 2 \"{message}\"");
    }
}

使用了 IOC，可以注入IMessenger服务替换Messenger.Default使用，Messenger是IMessenger接口的默认实现，Messenger.Default是单例引用。

public class MessageTestViewModel : ViewModelBase
{
    private readonly IMessenger _messenger;

    public MessageTestViewModel(IMessenger messenger)
    {
        _messenger = messenger;
        _messenger.Subscribe(this);
    }

    [EventHandler]
    public void ReceiveEventBusMessage(TestMessage message)
    {
        _notificationService?.Show("CodeWF EventBus",
            $"模块【Test】收到{nameof(TestMessage)}，Name: {message.Name}, Time: {message.CurrentTime}");
    }
}

手动订阅可以在 WPF 的 ViewModel 中使用（代码如上），也可以在 IOC 其他生命周期的服务中使用：

public class TimeService : ITimeService
{
    private readonly IMessenger _messenger;

    public TimeService(IMessenger messenger)
    {
        _messenger = messenger;

        _messenger.Subscribe(this);
    }

    [EventHandler]
    public void ReceiveEventBusMessage(TestMessage message)
    {
    }
}

手动注册可运用在无法或不需要单例注入的情况使用。

2.4. 发布消息

发布就比较简单：

_messenger.Publish(this, new TestMessage(this, nameof(MessageTestViewModel), TestClass.CurrentTime()));

比如在B/S控制器的Action使用：

[ApiController]
[Route("[controller]")]
public class EventController : ControllerBase
{
    private readonly ILogger<EventController> _logger;
    private readonly IMessenger _messenger;

    public EventController(ILogger<EventController> logger, IMessenger messenger)
    {
        _logger = logger;
        _messenger = messenger;
    }

    [HttpPost]
    public void Add()
    {
        _messenger.Publish(this, new CreateProductMessage(this, $"{DateTime.Now:HHmmss}号产品"));
    }

    [HttpDelete]
    public void Delete()
    {
        _messenger.Publish(this, new DeleteProductMessage(this, $"{DateTime.Now:HHmmss}号"));
    }
}

在WPF/Avalonia UI的ViewModel中使用:

public class MessageTestViewModel : ViewModelBase
{
    private readonly IMessenger _messenger;

    public MessageTestViewModel(IMessenger messenger)
    {
        _messenger = messenger;
    }

    public Task ExecuteEventBusAsync()
    {
        _messenger.Publish(this, new TestMessage(this, nameof(MessageTestViewModel), TestClass.CurrentTime()));
        return Task.CompletedTask;
    }
}

2.5. 取消订阅消息（事件）

支持消息处理程序的注销：

1. 注销指定处理程序：Messenger.Default.Unsubscribe<CreateProductMessage>(this, ReceiveManuCreateProductMessage)
2. 注销指定类的所有处理程序：Messenger.Default.Unsubscribe(this)

3. 总结

CodeWF.EventBus，一款灵活的事件总线库，实现模块间解耦通信。支持多种.NET 项目类型，如 Avalonia UI、WPF、WinForms、ASP.NET Core 等。采用简洁设计，轻松实现事件的发布与订阅。通过有序的消息处理，确保事件得到妥善处理。

简化您的代码，提升系统可维护性。

立即体验 CodeWF.EventBus，让事件处理更加高效！

仓库地址 https://github.com/dotnet9/CodeWF.EventBus，具体使用可参考Demo如下：

1. 控制台：ConsoleDemo
2. WPF: WPFDemo
3. AvaloniaUI + Prism：Tools.CodeWF
4. Web API：WebAPIDemo

开发过程中参考不少开源项目，他们是：

1. Messenger | MvvmCross
2. Prism.Events
3. MediatR
4. MASA Framework