概述
事件总线是一种事件发布/订阅结构，通过发布订阅模式可以解耦不同架构层级，同样它也可以来解决业务之间的耦合，它有以下优点
发布订阅模式
通过下图我们可以快速了解发布订阅模式的本质
- 订阅者将自己关心的事件在调度中心进行注册
- 事件的发布者通过调度中心把事件发布出去
- 订阅者收到自己关心的事件变更并执行相对应业务
![EventBus.png]()
其中发布者无需知道订阅者是谁，订阅者彼此之间也互不认识，彼此之间互不干扰
事件总线类型
在Masa Framework中，将事件划分为
本地事件，它的发布与订阅需要在同一个进程中，订阅方与发布方需要在同一个项目中
集成事件，它的发布与订阅一定不在同一个进程中，订阅方与发布方可以在同一个项目中，也可以在不同的项目中
下面我们会用一个注册用户的例子来说明如何使用本地事件
入门
- 新建ASP.NET Core 空项目
Assignment.InProcessEventBus，并安装Masa.Contrib.Dispatcher.Events
dotnet new web -o Assignment.InProcessEventBus
cd Assignment.InProcessEventBus
dotnet add package Masa.Contrib.Dispatcher.Events --version 0.7.0-preview.7
- 注册EventBus (用于发布本地事件), 修改
Program.cs
builder.Services.AddEventBus();
- 新增
RegisterUserEvent类并继承Event，用于发布注册用户事件
public record RegisterEvent : Event
{
public string Account { get; set; }
public string Email { get; set; }
public string Password { get; set; }
}
- 新增
注册用户处理程序
在指定事件处理程序方法上增加特性 EventHandler，并在方法中增加参数 RegisterUserEvent
public class UserHandler
{
private readonly ILogger<UserHandler>? _logger;
public UserHandler(ILogger<UserHandler>? logger = null)
{
//todo: 根据需要可在构造函数中注入其它服务 (需支持从DI获取)
_logger = logger;
}
[EventHandler]
public void RegisterUser(RegisterUserEvent @event)
{
//todo: 1. 编写注册用户业务
_logger?.LogDebug("-----------{Message}-----------", "检测用户是否存在并注册用户");
//todo: 2. 编写发送注册通知等
_logger?.LogDebug("-----------{Account} 注册成功 {Message}-----------", @event.Account, "发送邮件提示注册成功");
}
}
注册用户的处理程序可以放到任意一个类中，但其构造函数参数必须支持从DI获取，且处理程序的方法仅支持 Task或 Void 两种, 不支持其它类型
- 发送注册用户事件，修改
Program.cs
app.MapPost("/register", async (RegisterUserEvent @event, IEventBus eventBus) =>
{
await eventBus.PublishAsync(@event);
});
进阶
处理流程
EventBus的 请求管道包含一系列请求委托，依次调用。 它们与ASP.NET Core中间件有异曲同工之妙，区别点在于中间件的执行顺序与注册顺序相反，最先注册的最后执行
![EventBus.png]()
每个委托均可在下一个委托前后执行操作，其中TransactionMiddleware是EventBus发布后第一个要进入的中间件 (默认提供)，并且它是不支持多次嵌套的。
EventBus 支持嵌套，这意味着我们可以在Handler中重新发布一个新的Event，但TransactionMiddleware仅会在最外层进入时被触发一次
自定义中间件
根据需要我们可以自定义中间件，并注册到EventBus的请求管道中，比如通过增加FluentValidation, 将参数验证从业务代码中剥离开来，从而使得处理程序更专注于业务
- 注册
FluentValidation, 修改Program.cs
builder.Services.AddValidatorsFromAssembly(Assembly.GetEntryAssembly());
- 自定义验证中间件
ValidatorMiddleware.cs，用于验证参数
public class ValidatorMiddleware<TEvent> : Middleware<TEvent>
where TEvent : IEvent
{
private readonly ILogger<ValidatorMiddleware<TEvent>>? _logger;
private readonly IEnumerable<IValidator<TEvent>> _validators;
public ValidatorMiddleware(IEnumerable<IValidator<TEvent>> validators, ILogger<ValidatorMiddleware<TEvent>>? logger = null)
{
_validators = validators;
_logger = logger;
}
public override async Task HandleAsync(TEvent @event, EventHandlerDelegate next)
{
var typeName = @event.GetType().FullName;
_logger?.LogDebug("----- Validating command {CommandType}", typeName);
var failures = _validators
.Select(v => v.Validate(@event))
.SelectMany(result => result.Errors)
.Where(error => error != null)
.ToList();
if (failures.Any())
{
_logger?.LogError("Validation errors - {CommandType} - Event: {@Command} - Errors: {@ValidationErrors}",
typeName,
@event,
failures);
throw new ValidationException("Validation exception", failures);
}
await next();
}
}
- 注册EventBus并使用验证中间件
ValidatorMiddleware
builder.Services.AddEventBus(eventBusBuilder=>eventBusBuilder.UseMiddleware(typeof(ValidatorMiddleware<>)));
- 添加注册用户验证类
RegisterUserEventValidator.cs
public class RegisterUserEventValidator : AbstractValidator<RegisterUserEvent>
{
public RegisterUserEventValidator()
{
RuleFor(e => e.Account).NotNull().WithMessage("用户名不能为空");
RuleFor(e => e.Email).NotNull().WithMessage("邮箱不能为空");
RuleFor(e => e.Password)
.NotNull().WithMessage("密码不能为空")
.MinimumLength(6)
.WithMessage("密码必须大于6位")
.MaximumLength(20)
.WithMessage("密码必须小于20位");
}
}
编排
EventBus 支持事件编排，它们可以用来处理一些对执行顺序有要求的业务，比如: 注册用户必须成功之后才可以发送注册邮件通知，发送奖励等等，那我们可以这样做
将注册用户业务拆分为三个Handler，并通过指定Order的值来对执行事件排序
public class UserHandler
{
private readonly ILogger<UserHandler>? _logger;
public UserHandler(ILogger<UserHandler>? logger = null)
{
_logger = logger;
}
[EventHandler(1)]
public void RegisterUser(RegisterUserEvent @event)
{
_logger?.LogDebug("-----------{Message}-----------", "检测用户是否存在并注册用户");
//todo: 编写注册用户业务
}
[EventHandler(2)]
public void SendAwardByRegister(RegisterUserEvent @event)
{
_logger?.LogDebug("-----------{Account} 注册成功 {Message}-----------", @event.Account, "发送注册奖励");
//todo: 编写发送奖励等
}
[EventHandler(3)]
public void SendNoticeByRegister(RegisterUserEvent @event)
{
_logger?.LogDebug("-----------{Account} 注册成功 {Message}-----------", @event.Account, "发送注册成功邮件");
//todo: 编写发送注册通知等
}
}
Saga
EventBus支持Saga模式
![Saga]()
具体是怎么做呢？
[EventHandler(1, IsCancel = true)]
public void CancelSendAwardByRegister(RegisterUserEvent @event)
{
_logger?.LogDebug("-----------{Account} 注册成功，发放奖励失败 {Message}-----------", @event.Account, "发放奖励补偿");
}
当发送奖励出现异常时，则执行补偿机制，执行顺序为 (2 - 1) > 0，由于目前仅存在一个Order为1的Handler，则执行奖励补偿后退出
但对于部分不需要执行失败但不需要执行回退的方法，我们可以修改 FailureLevels 确保不会因为当前方法的异常而导致执行补偿机制
[EventHandler(3, FailureLevels = FailureLevels.Ignore)]
public void SendNoticeByRegister(RegisterUserEvent @event)
{
_logger?.LogDebug("-----------{Account} 注册成功 {Message}-----------", @event.Account, "发送邮件提示注册成功");
//todo: 编写发送注册通知等
}
源码解读
EventHandler
- FailureLevels: 失败级别, 默认: Throw
- Throw：发生异常后，依次执行Order小于当前Handler的Order的取消动作，比如：Handler顺序为 1、2、3，CancelHandler为 1、2、3，如果执行 Handler3 异常，则依次执行 2、1
- ThrowAndCancel：发生异常后，依次执行Order小于等于当前Handler的Order的取消动作，比如：Handler顺序为 1、2、3，CancelHandler为 1、2、3，如果执行 Handler3 异常，则依次执行 3、2、1
- Ignore：发生异常后，忽略当前异常（不执行取消动作），继续执行其他Handler
- Order: 执行顺序，默认: int.MaxValue，用于控制当前方法的执行顺序
- EnableRetry: 当Handler异常后是否启用重试, 默认: false
- RetryTimes: 重试次数，当出现异常后执行多少次重试, 需开启重试配置
- IsCancel: 是否是补偿机制，默认: false
Middleware<TEvent>
- SupportRecursive: 是否支持递归 (嵌套), 默认: true
- HandleAsync(TEvent @event, EventHandlerDelegate next): 处理程序，通过调用
next() 使得请求进入下一个Handler
IEventHandler<TEvent> 与 ISagaEventHandler<TEvent>
- HandleAsync(TEvent @event): 提供事件的Handler
- CancelAsync(TEvent @event): 提供事件的补偿Handler
与EventHandler功能类似，提供基本的Handler以及补偿Handler，推荐使用EventHandler的方式使用
TransactionMiddleware
提供事务中间件，当EventBus与UoW以及Masa提供的Repository来使用时，当存在待提交的数据时，会自动执行保存并提交，当出现异常后，会执行事务回滚，无需担心脏数据入库
性能测试
与市面上使用较多的MeidatR作了对比，结果如下图所示:
BenchmarkDotNet=v0.13.1, OS=Windows 10.0.19043.1023 (21H1/May2021Update) 11th Gen Intel Core i7-11700 2.50GHz, 1 CPU, 16 logical and 8 physical cores .NET SDK=7.0.100-preview.4.22252.9 [Host] : .NET 6.0.6 (6.0.622.26707), X64 RyuJIT DEBUG Job-MHJZJL : .NET 6.0.6 (6.0.622.26707), X64 RyuJIT
Runtime=.NET 6.0 IterationCount=100 RunStrategy=ColdStart
| Method |
Mean |
Error |
StdDev |
Median |
Min |
Max |
| AddShoppingCartByEventBusAsync |
124.80 us |
346.93 us |
1,022.94 us |
8.650 us |
6.500 us |
10,202.4 us |
| AddShoppingCartByMediatRAsync |
110.57 us |
306.47 us |
903.64 us |
7.500 us |
5.300 us |
9,000.1 us |
根据性能测试我们发现，EventBus与MediatR性能差距很小，但EventBus提供的功能却要强大的多
常见问题
- 按照文档操作，通过
EventBus发布事件后，对应的Handler并没有执行，也没有发现错误？
①. EventBus.PublishAsync(@event) 是异步方法，确保等待方法调用成功，检查是否出现同步方法调用异步方法的情况 ②. 注册EventBus时指定程序集集合, Assembly被用于注册时获取并保存事件与Handler的对应关系
var assemblies = new[]
{
typeof(UserHandler).Assembly
};
builder.Services.AddEventBus(assemblies);
程序集: 手动指定Assembly集合 -> MasaApp.GetAssemblies() -> AppDomain.CurrentDomain.GetAssemblies()
但由于NetCore按需加载，未使用的程序集在当前域中不存在，因此可能会导致部分事件以及Handler的对应关系未正确保存，因此可通过手动指定Assembly集合或者修改全局配置中的Assembly集合来修复这个问题
- 通过EventBus发布事件，Handler出错，但数据依然保存到数据库中
①. 检查是否禁用事务
- DisableRollbackOnFailure是否为true (是否失败时禁止回滚)
- UseTransaction是否为false (禁止使用事务)
②. 检查当前数据库是否支持回滚。例如: 使用的是Mysql数据库，但回滚数据失败，请查看
本章源码
Assignment11
https://github.com/zhenlei520/MasaFramework.Practice
开源地址
MASA.Framework：https://github.com/masastack/MASA.Framework
如果你对我们的 MASA Framework 感兴趣，无论是代码贡献、使用、提 Issue，欢迎联系我们
- WeChat：MasaStackTechOps
- QQ：7424099
