游戏客户端架构 / 系统课时

把对象装配从业务逻辑移开

把对象装配从业务逻辑移开

当敌人组件在受击逻辑中自行创建生命值、音效和表现服务时,功能虽然能运行,替换实现和编写测试却会越来越困难。本课将创建、依赖绑定和默认实现选择集中到装配入口,让业务对象专注运行时行为,并验证装配后的调用结果。

学习目标

  • 识别业务逻辑中混入的对象创建、实现选择和依赖绑定职责。
  • 建立独立的装配入口,集中创建和连接对象组件。
  • 验证默认实现、对象生命周期和测试替换是否符合预期。

识别业务代码中的装配职责

假设一个敌人在受到攻击时需要更新生命值并触发受击反馈。合理的业务职责是计算本次伤害产生的状态变化,然后通知表现层;不合理的做法是在每次受击时重新创建生命值组件、音效播放器或全局服务。

判断创建操作是否应该移走,可以看它是否决定了组件的具体实现、生命周期或共享范围。比如选择 ConsoleHitFeedback 还是游戏内音效实现,这是装配决策,不是敌人受击规则。

并非业务代码中所有 new 都有问题。创建一次性计算结果、临时数据对象通常属于业务行为。真正需要移动的是那些承担外部协作职责、需要替换或需要跨调用存活的对象创建代码。

建立创建和运行的两条边界

可以将对象工作过程分成装配阶段和运行阶段。装配阶段创建状态组件、选择默认反馈实现,并向业务对象注入接口;运行阶段只调用已经绑定的依赖,不重新决定使用哪个具体类。

游戏对象装配入口与运行时业务协作的数据流

装配入口也称 Composition Root。它不一定是一个单独文件,但应该在架构上具有明确位置,例如游戏启动入口、场景初始化器或对象生成工厂。业务组件不应为了获取依赖反向调用装配入口,否则只是把服务定位器换了一个名字。

实际装配需要决定三类信息:对象由谁创建、依赖具体绑定到什么实现、对象存活多久。例如生命值通常每个敌人独立创建,而日志或资源管理服务可能由多个对象共享。不同生命周期的对象不能随意注册成同一个全局实例。

在装配入口选择默认实现

以下示例使用独立的 C# 类模拟敌人组件系统。生命值状态与受击反馈由两个接口定义,Enemy 只负责协调调用,GameComposition 集中创建它们并选择默认实现。

将以下代码保存为 .NET 控制台项目的 Program.cs,即可使用 dotnet run 验证结果。

csharp
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);
    }
}

预期输出:

text
受到攻击,剩余 HP=28

CreateEnemy 每次调用都会创建独立的 Health 和 Enemy 实例,并为敌人连接反馈实现。ReceiveHit 不含任何具体实现的构造逻辑,只按照稳定顺序更新状态并通知反馈。因此,生命值从 40 变为 28 后,输出与业务调用一致。

这里的 ConsoleHitFeedback 是一个可运行的示范默认实现,并非游戏引擎的音效系统。真实项目可以在装配入口替换为音效、动画或统一事件通知适配器,而不必修改 Enemy.ReceiveHit。

让装配保持可替换和可验证

将创建移动出去之后,最重要的收益不是代码行数减少,而是替换依赖时只需要修改装配层。比如单元测试可以直接构造 Enemy,传入一个用于记录伤害的 IHealth 实现和一个收集反馈参数的 IHitFeedback 实现,不需要创建真实游戏场景。

装配正确性可以从以下场景验证:

  1. 使用默认装配创建生命值为 40 的敌人,施加 12 点伤害,确认反馈值为 28。
  2. 连续对同一个敌人调用受击方法,确认生命值持续变化,而不是每次重新初始化。
  3. 创建两个敌人,确认其中一个受到伤害不会改变另一个的生命值。
  4. 将反馈实现替换为测试对象,确认只需修改创建方式,业务类本身无需改动。

还要验证装配失败的处理方式。示例中的必需依赖为 null 时,构造器会立即抛出 ArgumentNullException;非法初始生命值或负伤害会由生命值组件拒绝。这样能够在错误产生的位置暴露问题,而不是让缺失依赖在后续游戏帧中引发不明确的故障。

处理动态对象和生命周期

真实游戏中的对象往往通过预制体、场景加载或对象池创建。此时不必为所有对象使用同一个全局装配函数,可以为不同敌人类型设计独立工厂,但这些工厂仍应复用统一的接口契约和依赖创建规则。

对池化对象,需要区分首次创建和再次启用。不会变化的基础服务可以在首次创建时绑定,而目标引用、临时状态或事件订阅必须根据复用协议重置。归还对象池前,应取消对象自己建立的订阅,避免已停用对象继续响应事件。

在 Unity 等引擎中,装配还必须遵守引擎管理的对象生命周期。对于需要显式初始化的组件,业务入口应在初始化完成后才允许执行;不能假设外部调用 Initialize 一定早于引擎的所有生命周期回调。

当装配入口逐渐变大时,可以按场景、敌人类型或功能模块拆分工厂,再由上层入口组织它们。拆分后的业务组件仍不负责选择具体实现,避免创建职责重新散落到各处。

这套方式的关键边界是:装配层决定对象如何创建、连接和释放,业务层决定对象收到操作后如何行动。 只要保持这条边界,增加新的组件实现、替换反馈机制或引入对象池,都能尽量局限在装配和生命周期管理代码中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

把对象装配从业务逻辑移开

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通