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

依赖是自己找还是外部传入

依赖是自己找还是外部传入

当攻击组件需要访问目标的生命值组件时,可以自行查找,也可以让外部提前传入。两种方式都能完成攻击,却会影响组件的复用、测试和生命周期管理。本课比较四种常见依赖获取方式,并建立可执行的选择规则。

学习目标

  • 区分服务定位、组件查询、构造注入和外部装配的职责与代价。
  • 使用接口和构造注入实现可独立测试的组件协作。
  • 根据依赖是否必需、作用范围和生命周期选择获取方式。

依赖获取方式决定了什么

假设 AttackComponent 需要调用目标的 IDamageReceiver 接口。这里真正需要的是接收伤害的能力,而不是整个敌人对象。依赖获取方式决定了攻击组件是否需要知道能力实现的位置、创建方式和具体类型。

常见方式可以分为四种:

方式 依赖来源 主要优点 主要风险
服务定位 向服务注册表请求实例 调用方不必逐层传递服务 依赖隐藏,测试依赖注册环境
组件查询 从对象或对象层级中寻找组件 适合对象内局部能力发现 依赖对象结构和查询结果
构造注入 创建组件时传入依赖 必需依赖显式、易测试 需要创建方负责提供依赖
外部装配 专门的装配入口创建并连接对象 集中管理实现选择和生命周期 装配入口可能膨胀

前两种属于组件主动获取依赖,后两种强调由外部控制依赖。不过,构造注入和外部装配并非互斥关系:注入描述组件如何接收依赖,装配描述谁负责创建并传递依赖。

四种依赖获取方式的控制权和依赖方向对比

根据作用范围选择获取方式

服务定位适合启动阶段统一获取少量基础设施服务,但不应成为所有业务组件的默认入口。例如攻击组件每次命中都调用 GameServices.Get<IDamageReceiver>(),不仅隐藏目标来源,还可能错误地将全局服务当成当前敌人的生命值组件。

组件查询适合对象自身的局部能力。在 Unity 中,GetComponent<HealthComponent>() 可以获取同一 GameObject 上的对应组件。若依赖属于父对象、子对象或另一个实体,就需要明确查询范围,不能假设所有组件都在同一对象上。

构造注入适合创建后始终存在的必需依赖。攻击组件必须具备伤害接收目标才能正常工作,就可以在构造时要求传入 IDamageReceiver。组件无需知道目标从哪里创建,也不需要访问服务注册表。

外部装配适合多个对象或组件需要统一连接的情况。装配入口可以负责选择具体实现、处理配置和确定实例的共享范围。它通常与构造注入配合使用,而不是替代构造注入。

选择时先回答三个问题:依赖是不是必需的?依赖属于当前对象还是共享系统?依赖会不会在运行中变化?这比简单规定所有组件都必须使用某一种方式更可靠。

使用构造注入实现攻击协作

下面使用不依赖具体游戏引擎的 C# 示例验证显式依赖。HealthComponent 管理生命值,AttackComponent 只调用伤害接口。示例可以直接放入 .NET 控制台项目的 Program.cs 中运行。

csharp
using System;

// 契约只暴露接收伤害的能力。
public interface IDamageReceiver
{
    int TakeDamage(int amount);
}

public sealed class HealthComponent : IDamageReceiver
{
    public int Hp { get; private set; }

    public HealthComponent(int initialHp)
    {
        if (initialHp < 0)
            throw new ArgumentOutOfRangeException(nameof(initialHp));
        Hp = initialHp;
    }

    public int TakeDamage(int amount)
    {
        // 在状态所属组件内统一维护数值边界。
        if (amount < 0)
            throw new ArgumentOutOfRangeException(nameof(amount));

        Hp = Math.Max(0, Hp - amount);
        return Hp;
    }
}

public sealed class AttackComponent
{
    private readonly IDamageReceiver _target;

    // 必需依赖在创建阶段传入并完成校验。
    public AttackComponent(IDamageReceiver target)
    {
        _target = target ?? throw new ArgumentNullException(nameof(target));
    }

    public void Hit(int damage)
    {
        int remaining = _target.TakeDamage(damage);
        Console.WriteLine($"命中后 HP={remaining}");
    }
}

public static class Program
{
    public static void Main()
    {
        // 模拟外部创建并连接两个组件。
        var health = new HealthComponent(40);
        var attack = new AttackComponent(health);

        attack.Hit(12);
        attack.Hit(50);
    }
}

预期输出:

text
命中后 HP=28
命中后 HP=0

第一次攻击将生命值从 40 降至 28,第二次伤害超过剩余生命值,但 HealthComponent 将结果限制为 0。攻击组件没有查询对象层级,也没有创建生命值组件,因而可以接入其他实现 IDamageReceiver 的对象。

这个设计还有一个直接的测试收益:测试时可以传入记录伤害调用次数的假对象,而不必启动真实场景或建立全局服务注册表。接口注入让组件的输入和依赖都变得可观察。

在游戏引擎中处理创建限制

普通 C# 对象可以通过构造器注入依赖,但引擎托管对象未必能够使用相同方式。Unity 的 MonoBehaviour 通常由引擎创建,不适合依赖自定义构造器参数完成注入;可以使用序列化引用、组件查询或显式的 Initialize 方法进行绑定。

使用初始化方法时,需要约定完成绑定之前不得执行依赖业务逻辑。尤其要注意 Awake、OnEnable 等生命周期回调可能先于外部装配方法运行,不能在这些回调中无条件使用尚未注入的依赖。

动态目标也不应强行建模为永久构造依赖。例如攻击者在战斗中切换目标,可以把目标作为 Hit 的参数传入,或者由明确的目标管理组件维护当前目标。稳定的必需服务适合注入,持续变化的运行时数据适合按操作传递或显式更新。

检查依赖是否被正确表达

完成设计后,可以用以下条件检查依赖边界:

  • 缺少必需依赖时,是否能在创建或初始化阶段立即发现,而不是第一次攻击时才报错?
  • 组件是否只依赖所需能力的接口,而不是读取整个对象的内部组件集合?
  • 使用组件查询时,是否明确查询对象、查询次数以及组件不存在时的处理方式?
  • 替换实现或编写单元测试时,是否无需修改组件内部的查找代码?

最终选择原则是:对象自身的可选局部能力可以查询;创建后必不可少的能力优先显式注入;共享基础设施由装配入口统一管理;随战斗变化的目标应通过清晰的运行时接口更新。这样既保留组件化的便利,也避免把组件变成依赖全局环境才能工作的黑盒。

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

目录与阅读设置

阅读设置

17

记录一个想法

依赖是自己找还是外部传入

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

登录哪都通