CodeWF.EventBus：轻量级事件总线，让通信更流畅
1. CodeWF.EventBus
EventBus(事件总线)，用于解耦模块之间的通讯。本库（CodeWF.EventBus）适用于进程内消息传递（无其他外部依赖），与大家普遍使用的MediatR通知功能类似，但MediatR库侧重于ASP.NET Core设计使用，本库优势：
- 设计可在各种模板项目使用，如 WPF、Winform、Avalonia UI、ASP.NET Core 等。
- 支持使用了 IOC 容器的项目，当然也支持未使用任何 IOC 容器的模板项目。
- 参考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. 取消订阅消息（事件）
支持消息处理程序的注销：
- 注销指定处理程序：
Messenger.Default.Unsubscribe<CreateProductMessage>(this, ReceiveManuCreateProductMessage) - 注销指定类的所有处理程序：
Messenger.Default.Unsubscribe(this)
3. 总结
CodeWF.EventBus，一款灵活的事件总线库，实现模块间解耦通信。支持多种.NET 项目类型，如 Avalonia UI、WPF、WinForms、ASP.NET Core 等。采用简洁设计，轻松实现事件的发布与订阅。通过有序的消息处理，确保事件得到妥善处理。
简化您的代码，提升系统可维护性。
立即体验 CodeWF.EventBus，让事件处理更加高效！
仓库地址 https://github.com/dotnet9/CodeWF.EventBus，具体使用可参考Demo如下：
- 控制台：ConsoleDemo
- WPF: WPFDemo
- AvaloniaUI + Prism：Tools.CodeWF
- Web API：WebAPIDemo
开发过程中参考不少开源项目，他们是：
