Files
ShrinkEventBus/Tests/EventBusDispatchTests.cs
T
cneicy 8acccdcc4b feat: 重构事件总线为可实例化架构并发布 1.3.0
- 新增 IShrinkEventBus、ShrinkEventBusBuilder 与 ShrinkEventBusInstance,支持独立 bus、异常策略、启动开关、类型校验和按 phase 派发
- 新增 SubscribeEvent 可释放订阅句柄与订阅快照接口,保留 EventBus 静态门面并委托到默认实例
- 重构监听列表为父子事件链共享锁与快照缓存,支持父事件监听子事件、跨父子数字优先级归并和防御性快照拷贝
- 优化 EventBase 元数据缓存、懒生成 EventId、派发快照挂接与对象池双重归还保护,移除旧 EventCache 热路径
- 恢复本地 ILPostProcessor 兜底并生成静态订阅注册表,避免共享 CodeGen 覆盖外程序集自动注册失效
- 改进事件查看器、Benchmark、README 与 CHANGELOG,并新增 Dispatch/Priority/Registration/Subscription 测试覆盖核心行为

BREAKING CHANGE: 移除 EventBase.GetListenerList(),int 数字优先级重载不再提供默认值,数字优先级 0 现在映射为 NORMAL。
2026-06-18 17:05:16 +08:00

201 lines
6.4 KiB
C#

using System;
using System.Collections.Generic;
using Cysharp.Threading.Tasks;
using NUnit.Framework;
namespace ShrinkEventBus.Tests
{
[TestFixture]
public sealed class EventBusDispatchTests
{
private class PlainEvent : EventBase
{
}
private sealed class DerivedPlainEvent : PlainEvent
{
}
[Cancelable]
private sealed class CancelableEvent : EventBase
{
}
[HasResult]
private sealed class ResultEvent : EventBase
{
}
[Test]
public void TriggerEvent_ReturnsFalseWithoutSubscribers_TrueWhenHandled()
{
var bus = EventBus.CreateBus();
Assert.IsFalse(bus.TriggerEvent(new PlainEvent()));
bus.RegisterEvent<PlainEvent>(_ => { }, EventPriority.NORMAL);
Assert.IsTrue(bus.TriggerEvent(new PlainEvent()));
}
[Test]
public void CanceledEvent_SkipsHandlersUnlessReceiveCanceled()
{
var bus = EventBus.CreateBus();
var order = new List<string>();
bus.RegisterEvent<CancelableEvent>(evt =>
{
order.Add("canceler");
evt.SetCanceled(true);
}, EventPriority.HIGHEST);
bus.RegisterEvent<CancelableEvent>(_ => order.Add("skipped"), EventPriority.NORMAL);
bus.RegisterEvent<CancelableEvent>(evt => order.Add($"monitor:{evt.IsCanceled}"),
EventPriority.MONITOR, receiveCanceled: true);
var evt = new CancelableEvent();
bus.TriggerEvent(evt);
Assert.IsTrue(evt.IsCanceled);
CollectionAssert.AreEqual(new[] { "canceler", "monitor:True" }, order);
}
[Test]
public void SetCanceled_OnNonCancelableEvent_ThrowsWithMessage()
{
var evt = new PlainEvent();
var ex = Assert.Throws<UnsupportedOperationException>(() => evt.SetCanceled(true));
Assert.IsFalse(string.IsNullOrWhiteSpace(ex.Message));
}
[Test]
public void SetResult_OnEventWithoutResult_ThrowsWithMessage()
{
var evt = new PlainEvent();
var ex = Assert.Throws<InvalidOperationException>(() => evt.SetResult(EventResult.ALLOW));
Assert.IsFalse(string.IsNullOrWhiteSpace(ex.Message));
}
[Test]
public void SetResult_OnResultEvent_PersistsResult()
{
var bus = EventBus.CreateBus();
bus.RegisterEvent<ResultEvent>(evt => evt.SetResult(EventResult.DENY), EventPriority.HIGH);
var evt = new ResultEvent();
bus.TriggerEvent(evt);
Assert.AreEqual(EventResult.DENY, evt.Result);
}
[Test]
public void ParentSubscriber_ReceivesDerivedEvent()
{
var bus = EventBus.CreateBus();
var hits = 0;
bus.RegisterEvent<PlainEvent>(_ => hits++, EventPriority.NORMAL);
bus.TriggerEvent(new DerivedPlainEvent());
Assert.AreEqual(1, hits);
}
[Test]
public void ParentSubscriber_RegisteredAfterChildWasTriggered_StillReceivesChild()
{
var bus = EventBus.CreateBus();
// 先触发子事件,让子类型的监听列表先于父监听器创建(覆盖脏传播路径)
bus.TriggerEvent(new DerivedPlainEvent());
var hits = 0;
bus.RegisterEvent<PlainEvent>(_ => hits++, EventPriority.NORMAL);
bus.TriggerEvent(new DerivedPlainEvent());
Assert.AreEqual(1, hits);
}
[Test]
public void PerPhaseDispatch_OnlyRunsRequestedPhase()
{
var bus = EventBus.CreateBus(builder => builder.AllowPerPhaseDispatch());
var order = new List<string>();
bus.RegisterEvent<PlainEvent>(_ => order.Add("high"), EventPriority.HIGH);
bus.RegisterEvent<PlainEvent>(_ => order.Add("normal"), EventPriority.NORMAL);
bus.TriggerEvent(EventPriority.HIGH, new PlainEvent());
CollectionAssert.AreEqual(new[] { "high" }, order);
}
[Test]
public void PerPhaseDispatch_ThrowsWhenNotEnabled()
{
var bus = EventBus.CreateBus();
Assert.Throws<InvalidOperationException>(() => bus.TriggerEvent(EventPriority.HIGH, new PlainEvent()));
}
[Test]
public void TriggerEventAsync_RunsHandlersSequentiallyByPriority()
{
var bus = EventBus.CreateBus();
var order = new List<string>();
async UniTask AsyncHandler(PlainEvent evt)
{
order.Add("async-high");
await UniTask.CompletedTask;
}
bus.RegisterEvent<PlainEvent>(AsyncHandler, EventPriority.HIGH, receiveCanceled: false);
bus.RegisterEvent<PlainEvent>(_ => order.Add("sync-normal"), EventPriority.NORMAL);
var handled = bus.TriggerEventAsync(new PlainEvent()).GetAwaiter().GetResult();
Assert.IsTrue(handled);
CollectionAssert.AreEqual(new[] { "async-high", "sync-normal" }, order);
}
[Test]
public void TriggerEventAsync_AsyncHandlerCancellation_SkipsLaterHandlers()
{
var bus = EventBus.CreateBus();
var order = new List<string>();
async UniTask CancelingHandler(CancelableEvent evt)
{
evt.SetCanceled(true);
order.Add("async-canceler");
await UniTask.CompletedTask;
}
bus.RegisterEvent<CancelableEvent>(CancelingHandler, EventPriority.HIGHEST, receiveCanceled: false);
bus.RegisterEvent<CancelableEvent>(_ => order.Add("skipped"), EventPriority.NORMAL);
bus.TriggerEventAsync(new CancelableEvent()).GetAwaiter().GetResult();
CollectionAssert.AreEqual(new[] { "async-canceler" }, order);
}
[Test]
public void GetSubscribers_ReturnsDefensiveCopyOfDispatchSnapshot()
{
var bus = EventBus.CreateBus();
bus.RegisterEvent<PlainEvent>(_ => { }, EventPriority.NORMAL);
var evt = new PlainEvent();
bus.TriggerEvent(evt);
var first = evt.GetSubscribers();
Assert.AreEqual(1, first.Length);
first[0] = null;
var second = evt.GetSubscribers();
Assert.IsNotNull(second[0]);
}
}
}