游戏客户端架构 / 系统课时
泛型分发怎样避免类型判断
泛型分发怎样避免类型判断
当游戏客户端存在大量不同的事件时,如果分发器通过 if 或 switch 判断事件类型,每增加一种事件就可能需要修改公共代码。本课用 C# 泛型与类型映射建立独立事件通道,让订阅者直接接收正确类型的数据,而不必自行判断和转换事件对象。
学习目标
- 理解基于
object和连续类型判断的分发方式为什么难以维护。 - 掌握
Type到EventChannel<T>的映射机制。 - 实现并验证支持多个事件类型的强类型订阅与分发。
为什么不应该集中判断所有事件类型
假设游戏同时存在角色受伤、任务完成和物品拾取三类事件。如果所有消息都以 object 形式进入一个分发器,分发器就需要逐一判断对象属于哪种事件,再将其交给对应的业务代码。
这种设计让分发器必须认识全部事件类型,事件数量增长时,类型分支会越来越长。新增功能不仅要定义事件,还可能修改原有分发逻辑,增加遗漏分支和错误转换的风险。
泛型分发的关键变化是:事件类型由调用方法时的泛型参数确定,而不是由分发器逐个尝试识别。
例如,调用 Publish(new DamageTaken(7)) 时,编译器推断 T 为 DamageTaken。事件总线便可以使用 typeof(T) 直接定位对应的处理器集合,无须遍历其他事件类型。
类型映射怎样找到对应通道
一种更强类型的设计是为每个事件类型维护独立的 EventChannel<T>。每个通道内部只保存 Action<T>,因此订阅回调的参数类型在编译阶段就已经确定。
事件总线使用 Dictionary<Type, IEventChannel> 管理所有通道。字典键负责运行时查找,泛型通道负责处理器的类型约束和具体执行,两者职责清晰。

整个查找过程可以分为三个动作:首先通过 typeof(T) 获取类型键;然后从字典中查找对应通道;最后在通道内部调用 Action<T> 处理器。
由于每个通道只能保存自己的事件类型,业务回调不需要接收 object 再转换。不同类型即使包含相同字段,也不会自动进入彼此的订阅列表。
实现强类型事件通道
下面使用 .NET 8 或更新版本的控制台项目验证设计。将代码完整保存为 Program.cs,运行 dotnet run 即可观察不同事件类型的分发结果。示例包含两种事件、通道创建、订阅、发布和取消订阅,能够独立运行。
using System;
using System.Collections.Generic;
public readonly record struct DamageTaken(int Amount);
public readonly record struct QuestCompleted(string QuestId);
public interface IEventChannel { }
public sealed class EventChannel<T> : IEventChannel
{
// 每个通道只保存与自身事件类型匹配的回调
private readonly List<Action<T>> _handlers = new();
public bool IsEmpty => _handlers.Count == 0;
public void Add(Action<T> handler)
{
ArgumentNullException.ThrowIfNull(handler);
if (!_handlers.Contains(handler))
_handlers.Add(handler);
}
public bool Remove(Action<T> handler) => _handlers.Remove(handler);
public void Emit(T message)
{
// 快照保证回调内取消订阅不会破坏本次遍历
foreach (var handler in _handlers.ToArray())
handler(message);
}
}
public sealed class TypedEventBus
{
// 字典只通过泛型方法写入,保证类型键和通道对应
private readonly Dictionary<Type, IEventChannel> _channels = new();
private EventChannel<T> GetOrCreate<T>()
{
Type key = typeof(T);
if (_channels.TryGetValue(key, out var existing))
return (EventChannel<T>)existing;
var channel = new EventChannel<T>();
_channels.Add(key, channel);
return channel;
}
public void Subscribe<T>(Action<T> handler)
{
GetOrCreate<T>().Add(handler);
}
public bool Unsubscribe<T>(Action<T> handler)
{
if (!_channels.TryGetValue(typeof(T), out var existing))
return false;
var channel = (EventChannel<T>)existing;
bool removed = channel.Remove(handler);
if (channel.IsEmpty)
_channels.Remove(typeof(T));
return removed;
}
public void Publish<T>(T message)
{
// 只定位目标通道,不扫描其他事件类型
if (_channels.TryGetValue(typeof(T), out var existing))
((EventChannel<T>)existing).Emit(message);
}
}
public static class Program
{
public static void Main()
{
var bus = new TypedEventBus();
Action<DamageTaken> onDamage = e =>
Console.WriteLine($"Damage: {e.Amount}");
bus.Subscribe(onDamage);
bus.Subscribe<QuestCompleted>(e =>
Console.WriteLine($"Quest: {e.QuestId}"));
bus.Publish(new DamageTaken(7));
bus.Publish(new QuestCompleted("Q-17"));
bus.Unsubscribe(onDamage);
bus.Publish(new DamageTaken(2));
}
}预期输出:
Damage: 7
Quest: Q-17第一次发布进入 EventChannel<DamageTaken>,仅执行受伤事件处理器。第二次发布进入 EventChannel<QuestCompleted>,仅执行任务事件处理器。取消受伤订阅后,再次发布 DamageTaken 不产生输出。
如果尝试把 Action<QuestCompleted> 直接传给要求 Action<DamageTaken> 的订阅方法,编译器会报告类型不匹配。相比使用 object,这种限制能够在代码运行前发现许多错误。
泛型映射为什么只需要一次类型转换
Dictionary<Type, IEventChannel> 为了保存不同泛型实例,必须使用共同的接口类型。因此,从字典取出通道时,仍需将 IEventChannel 转换成 EventChannel<T>。
这并不意味着回到了逐个判断类型的设计。这里的转换只发生在找到目标通道之后,而不是对每个订阅者或每一种事件进行类型测试。
转换能够成立,依赖于一个重要约束:通道字典保持私有,并且只能通过统一的泛型方法创建和写入。
例如,当键是 typeof(DamageTaken) 时,创建出的值必然是 EventChannel<DamageTaken>。如果允许外部代码任意向字典写入其他通道,这个约束就可能失效,类型转换仍会在运行时抛出异常。
此外,Action<T> 的类型约束确保每条通道内部的回调都接收同一种事件数据。事件处理器可以直接读取 Amount 或 QuestId 等字段,而无需自行判断实际对象类型。
精确类型匹配有哪些边界
当前设计采用精确类型匹配。订阅 DamageTaken 只接收以该类型发布的消息,不会因为另一个事件拥有相同属性就自动接收它。若使用继承体系,也不会自动沿基类或接口向多个通道广播。
还要注意,泛型参数取决于调用时的静态类型。如果把派生事件保存在基类变量中,再通过该变量调用 Publish,通常会按基类类型查找通道,而不是自动改用实际运行时类型。项目应统一事件发布的类型约定。
性能方面,字典查找在正常哈希分布下平均为常数时间。如果目标类型有 个订阅者,则分发需要执行 次回调,时间复杂度为 。相比扫描所有事件类型和处理器,成本更接近实际需要通知的对象数量。
不过,示例中的 ToArray() 会在每次存在订阅者的发布操作中创建快照。对于每帧大量发布的高频事件,这可能产生额外内存分配。可以在确认性能瓶颈之后考虑缓存快照、延迟应用订阅变更等方案,但必须先定义好回调期间增删订阅的语义。
当游戏事件类型不断增加,而每种事件拥有不同的数据结构时,类型映射加独立泛型通道可以保持公共分发代码稳定。新增事件只需定义事件类型并注册相应处理器,无须不断扩展集中式类型判断分支。