游戏客户端架构 / 系统课时
把对象装配从业务逻辑移开
把对象装配从业务逻辑移开
当敌人组件在受击逻辑中自行创建生命值、音效和表现服务时,功能虽然能运行,替换实现和编写测试却会越来越困难。本课将创建、依赖绑定和默认实现选择集中到装配入口,让业务对象专注运行时行为,并验证装配后的调用结果。
学习目标
- 识别业务逻辑中混入的对象创建、实现选择和依赖绑定职责。
- 建立独立的装配入口,集中创建和连接对象组件。
- 验证默认实现、对象生命周期和测试替换是否符合预期。
识别业务代码中的装配职责
假设一个敌人在受到攻击时需要更新生命值并触发受击反馈。合理的业务职责是计算本次伤害产生的状态变化,然后通知表现层;不合理的做法是在每次受击时重新创建生命值组件、音效播放器或全局服务。
判断创建操作是否应该移走,可以看它是否决定了组件的具体实现、生命周期或共享范围。比如选择 ConsoleHitFeedback 还是游戏内音效实现,这是装配决策,不是敌人受击规则。
并非业务代码中所有 new 都有问题。创建一次性计算结果、临时数据对象通常属于业务行为。真正需要移动的是那些承担外部协作职责、需要替换或需要跨调用存活的对象创建代码。
建立创建和运行的两条边界
可以将对象工作过程分成装配阶段和运行阶段。装配阶段创建状态组件、选择默认反馈实现,并向业务对象注入接口;运行阶段只调用已经绑定的依赖,不重新决定使用哪个具体类。

装配入口也称 Composition Root。它不一定是一个单独文件,但应该在架构上具有明确位置,例如游戏启动入口、场景初始化器或对象生成工厂。业务组件不应为了获取依赖反向调用装配入口,否则只是把服务定位器换了一个名字。
实际装配需要决定三类信息:对象由谁创建、依赖具体绑定到什么实现、对象存活多久。例如生命值通常每个敌人独立创建,而日志或资源管理服务可能由多个对象共享。不同生命周期的对象不能随意注册成同一个全局实例。
在装配入口选择默认实现
以下示例使用独立的 C# 类模拟敌人组件系统。生命值状态与受击反馈由两个接口定义,Enemy 只负责协调调用,GameComposition 集中创建它们并选择默认实现。
将以下代码保存为 .NET 控制台项目的 Program.cs,即可使用 dotnet run 验证结果。
using System;
public interface IHealth
{
int Current { get; }
void Damage(int amount);
}
public sealed class Health : IHealth
{
public int Current { get; private set; }
public Health(int initialHp)
{
if (initialHp < 0)
throw new ArgumentOutOfRangeException(nameof(initialHp));
Current = initialHp;
}
public void Damage(int amount)
{
// 状态校验集中在生命值组件内部。
if (amount < 0)
throw new ArgumentOutOfRangeException(nameof(amount));
Current = Math.Max(0, Current - amount);
}
}
public interface IHitFeedback
{
void OnHit(int remainingHp);
}
public sealed class ConsoleHitFeedback : IHitFeedback
{
public void OnHit(int remainingHp)
{
Console.WriteLine($"受到攻击,剩余 HP={remainingHp}");
}
}
public sealed class Enemy
{
private readonly IHealth _health;
private readonly IHitFeedback _feedback;
// 业务对象接收能力接口,不负责实例化实现。
public Enemy(IHealth health, IHitFeedback feedback)
{
_health = health ?? throw new ArgumentNullException(nameof(health));
_feedback = feedback ?? throw new ArgumentNullException(nameof(feedback));
}
public void ReceiveHit(int amount)
{
_health.Damage(amount);
_feedback.OnHit(_health.Current);
}
}
public static class GameComposition
{
// 默认实现和实例生命周期在装配入口决定。
public static Enemy CreateEnemy(int initialHp)
{
IHealth health = new Health(initialHp);
IHitFeedback feedback = new ConsoleHitFeedback();
return new Enemy(health, feedback);
}
}
public static class Program
{
public static void Main()
{
// 运行阶段只使用完成装配的业务对象。
Enemy enemy = GameComposition.CreateEnemy(40);
enemy.ReceiveHit(12);
}
}预期输出:
受到攻击,剩余 HP=28CreateEnemy 每次调用都会创建独立的 Health 和 Enemy 实例,并为敌人连接反馈实现。ReceiveHit 不含任何具体实现的构造逻辑,只按照稳定顺序更新状态并通知反馈。因此,生命值从 40 变为 28 后,输出与业务调用一致。
这里的 ConsoleHitFeedback 是一个可运行的示范默认实现,并非游戏引擎的音效系统。真实项目可以在装配入口替换为音效、动画或统一事件通知适配器,而不必修改 Enemy.ReceiveHit。
让装配保持可替换和可验证
将创建移动出去之后,最重要的收益不是代码行数减少,而是替换依赖时只需要修改装配层。比如单元测试可以直接构造 Enemy,传入一个用于记录伤害的 IHealth 实现和一个收集反馈参数的 IHitFeedback 实现,不需要创建真实游戏场景。
装配正确性可以从以下场景验证:
- 使用默认装配创建生命值为 40 的敌人,施加 12 点伤害,确认反馈值为 28。
- 连续对同一个敌人调用受击方法,确认生命值持续变化,而不是每次重新初始化。
- 创建两个敌人,确认其中一个受到伤害不会改变另一个的生命值。
- 将反馈实现替换为测试对象,确认只需修改创建方式,业务类本身无需改动。
还要验证装配失败的处理方式。示例中的必需依赖为 null 时,构造器会立即抛出 ArgumentNullException;非法初始生命值或负伤害会由生命值组件拒绝。这样能够在错误产生的位置暴露问题,而不是让缺失依赖在后续游戏帧中引发不明确的故障。
处理动态对象和生命周期
真实游戏中的对象往往通过预制体、场景加载或对象池创建。此时不必为所有对象使用同一个全局装配函数,可以为不同敌人类型设计独立工厂,但这些工厂仍应复用统一的接口契约和依赖创建规则。
对池化对象,需要区分首次创建和再次启用。不会变化的基础服务可以在首次创建时绑定,而目标引用、临时状态或事件订阅必须根据复用协议重置。归还对象池前,应取消对象自己建立的订阅,避免已停用对象继续响应事件。
在 Unity 等引擎中,装配还必须遵守引擎管理的对象生命周期。对于需要显式初始化的组件,业务入口应在初始化完成后才允许执行;不能假设外部调用 Initialize 一定早于引擎的所有生命周期回调。
当装配入口逐渐变大时,可以按场景、敌人类型或功能模块拆分工厂,再由上层入口组织它们。拆分后的业务组件仍不负责选择具体实现,避免创建职责重新散落到各处。
这套方式的关键边界是:装配层决定对象如何创建、连接和释放,业务层决定对象收到操作后如何行动。 只要保持这条边界,增加新的组件实现、替换反馈机制或引入对象池,都能尽量局限在装配和生命周期管理代码中。