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

用接口隐藏具体组件实现

用接口隐藏具体组件实现

攻击组件一旦直接读取目标的生命值字段、护甲组件或动画状态,更换一种受击方式就需要修改调用方。本课用最小能力接口隔离攻击与受击实现,装配普通生命值和护甲生命值两种组件,并用实际输出验证替换过程。

学习目标

  • 识别具体组件依赖给替换与测试带来的成本。
  • 设计具有清晰参数和返回值的受击能力接口。
  • 让同一攻击组件调用两种实现,并验证结算结果。

识别具体类型泄漏

假设 AttackComponent 持有某个 Enemy,沿着对象引用找到 HealthComponent,再直接修改 hp。这种写法让攻击方知道目标的内部组成:以后目标改为护甲减伤、无敌状态或可破坏道具,就不得不加入更多类型判断。

真正稳定的需求只有一句:“向目标提交一次伤害,并知道结算结果。”调用方不应决定血量存在哪里,也不应负责播放受击动画。将能力从对象结构中提取出来,才有可能在不修改攻击代码的情况下更换实现。

设计最小受击契约

示例使用 IDamageReceiver 表示“可接收伤害”,只提供 ReceiveDamage(amount)。传入的是本次待结算的非负伤害值,返回 DamageResult,记录实际扣血量和剩余生命值。调用方只根据结果决定是否展示命中数字,不自行读写目标内部字段。

攻击组件通过能力接口连接不同受击实现

接口宜描述动作,而非暴露完整组件。如果把 hp、护甲、音效播放、动画参数都放进一个接口,调用方仍会依赖大量不相关细节。一个能力接口应允许不同实现独立履行同一约定。

编写并运行两种实现

下面是独立的 C# 示例。创建 .NET 8 控制台项目,把代码放进 Program.cs 即可运行。普通生命值直接扣血;护甲生命值先做固定减伤。攻击组件只保存 IDamageReceiver,完全不知道传入的是哪一种具体类。

csharp
using System;

public readonly record struct DamageResult(int AppliedDamage, int RemainingHp);

public interface IDamageReceiver
{
    DamageResult ReceiveDamage(int amount);
}

public sealed class HealthComponent : IDamageReceiver
{
    private int _hp;

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

    public DamageResult ReceiveDamage(int amount)
    {
        if (amount < 0) throw new ArgumentOutOfRangeException(nameof(amount));
        int applied = Math.Min(_hp, amount);
        _hp -= applied;
        return new DamageResult(applied, _hp);
    }
}

public sealed class ArmoredHealthComponent : IDamageReceiver
{
    private int _hp;
    private readonly int _armor;

    public ArmoredHealthComponent(int hp, int armor)
    {
        if (hp < 0 || armor < 0) throw new ArgumentOutOfRangeException();
        _hp = hp;
        _armor = armor;
    }

    public DamageResult ReceiveDamage(int amount)
    {
        if (amount < 0) throw new ArgumentOutOfRangeException(nameof(amount));
        // 实现类负责减伤规则,调用方不关心内部计算
        int applied = Math.Min(_hp, Math.Max(0, amount - _armor));
        _hp -= applied;
        return new DamageResult(applied, _hp);
    }
}

public sealed class AttackComponent
{
    private readonly IDamageReceiver _target;

    public AttackComponent(IDamageReceiver target)
    {
        _target = target ?? throw new ArgumentNullException(nameof(target));
    }

    public DamageResult Hit(int amount) => _target.ReceiveDamage(amount);
}

public static class Program
{
    public static void Main()
    {
        // 仅在装配时选择实现,无需修改攻击逻辑
        var normal = new AttackComponent(new HealthComponent(60));
        var armored = new AttackComponent(new ArmoredHealthComponent(60, 5));
        var a = normal.Hit(20);
        var b = armored.Hit(20);

        Console.WriteLine($"普通目标:扣{a.AppliedDamage},剩{a.RemainingHp}");
        Console.WriteLine($"护甲目标:扣{b.AppliedDamage},剩{b.RemainingHp}");
    }
}

预期输出:

text
普通目标:扣20,剩40
护甲目标:扣15,剩45

两次攻击都传入 20,区别只来自实现内部的护甲计算。将装配时的护甲值 5 改为 25,护甲目标本次应扣 0、剩余 60;AttackComponent 不需要任何修改。这也是测试替身能够替换真实组件的基础。

在装配边界连接依赖

示例在 Main 中选择实现;在游戏引擎中,应由对象创建、生成或初始化流程取得目标的受击能力,再交给攻击模块。这样类型查找发生在装配边界,而不是每次命中时反复沿对象层级搜索。若目标没有该能力,应明确认定其不可受击,避免空引用异常。

接口不能自动解决组件的生命周期。目标销毁、切换场景或重新生成后,旧引用可能失效;持有者需要通过宿主的生命周期规则重新绑定或停止调用。网络游戏还应由权威端负责最终伤害计算,接口本身不等于安全校验。

守住契约边界

示例规定负数伤害抛异常,0 伤害不改变生命值,超量伤害只扣到 0;AppliedDamage 永远是实际扣掉的量。不同实现必须遵循这些共同语义,否则虽然类型兼容,业务结果仍不可替换。

如果只有一个稳定实现,且调用与实现严格封闭在同一模块,额外接口可能只是徒增文件。存在多种受击对象、可替换规则或单元测试替身时,接口的价值才最明显。它解决的是“调用方依赖哪种能力”,不是“其他模块如何获知受击结果”;后者适合事件通知。

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

目录与阅读设置

阅读设置

17

记录一个想法

用接口隐藏具体组件实现

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

登录哪都通