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

设计稳定的组件接口

设计稳定的组件接口

攻击组件若直接读取某个角色脚本的生命值字段,遇到无敌目标、护盾或可破坏物时就得修改调用代码。本课从调用方实际需要的行为出发定义最小接口,再让两种不同实现接入同一攻击逻辑,验证替换时契约不变。

学习目标

  • 从使用者需求定义最小接口,而不是暴露实现类的内部状态。
  • 为参数、返回值和异常边界写出可验证的行为契约。
  • 用两种实现验证调用方无需分辨具体组件类型。

从调用者需要什么开始

攻击方真正需要的是“请求目标承受一次伤害,并知道实际生效多少”,而不是“把某个 Health 对象的 hp 减去一个值”。因此,可以把依赖收窄为 IDamageReceiver:接收正整数伤害请求,返回本次实际扣除量与是否在本次攻击中被击败。

这份契约需要先约定几个细节:请求值必须大于零;实际伤害 Applied 在零与请求量之间;JustDefeated 仅在本次调用令目标从存活转为失效时为真。无敌实现可以返回零,而普通生命组件可以扣血并报告结果。调用方不能依赖目标是否有 _hp 字段。

接口越“全能”,越容易把不相关能力绑在一起。IMovable 不应强制实现受伤或拾取;展示生命条的 UI 也不必获得修改生命值的权限。读取状态、接收命令和发布变化事件,可以根据实际消费者分别设计。

看清依赖方向

攻击调用方通过伤害接口连接不同实现的依赖架构

依赖方向应该是:攻击组件认识抽象契约,具体生命组件与无敌组件负责实现契约。这样替换目标时,改变的是对象装配,不是攻击流程中的类型判断。接口并不意味着没有依赖,而是把依赖限定为明确、可测试的行为承诺。

运行两种实现验证接口替换

以下完整示例可放入 .NET 8 控制台项目的 Program.cs。同一个 Attack.Strike 先攻击普通生命组件两次,再攻击无敌目标,整个过程中不需要知道具体实现类。

csharp
using System;

var target = new Health(10);
Attack.Strike(target, 6);
Attack.Strike(target, 6);
Attack.Strike(new Invulnerable(), 6);

public readonly record struct DamageResult(int Applied, bool JustDefeated);

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

public sealed class Health : IDamageReceiver
{
    private int _hp;
    public Health(int initialHp)
    {
        if (initialHp <= 0)
            throw new ArgumentOutOfRangeException(nameof(initialHp));
        _hp = initialHp;
    }

    public DamageResult ReceiveDamage(int amount)
    {
        ArgumentOutOfRangeException.ThrowIfNegativeOrZero(amount);
        // 只报告实际扣除量,避免过量伤害产生负生命值。
        int applied = Math.Min(_hp, amount);
        _hp -= applied;
        return new DamageResult(applied, applied > 0 && _hp == 0);
    }
}

public sealed class Invulnerable : IDamageReceiver
{
    public DamageResult ReceiveDamage(int amount)
    {
        ArgumentOutOfRangeException.ThrowIfNegativeOrZero(amount);
        return new DamageResult(0, false);
    }
}

public static class Attack
{
    public static void Strike(IDamageReceiver target, int amount)
    {
        ArgumentNullException.ThrowIfNull(target);
        // 调用方只依赖契约和结果,不读取目标内部字段。
        var result = target.ReceiveDamage(amount);
        Console.WriteLine($"实际伤害={result.Applied},本次击败={result.JustDefeated}");
    }
}

预期输出:

text
实际伤害=6,本次击败=False
实际伤害=4,本次击败=True
实际伤害=0,本次击败=False

第一次攻击将生命值从 10 降到 4,第二次请求 6 点伤害时实际只能扣除 4,且仅这一次返回“本次击败”。无敌实现返回零,不要求攻击方添加 if (target is Health) 之类的具体类型分支。

把边界条件写成可测试契约

稳定接口不能只约定方法名,还要约定可观察行为。对于上面的 ReceiveDamage,可按以下情形验收:

输入与状态 约定结果
存活且伤害小于当前 HP 扣除请求值,JustDefeated=false
伤害超过剩余 HP 最多扣到零,仅首次归零为 true
已经归零后再次受伤 Applied=0,JustDefeated=false
无敌目标接收合法伤害 Applied=0,JustDefeated=false
请求伤害为零或负数 抛出参数越界异常,不修改状态

这里选择对非法请求抛异常,是为了及时暴露调用方错误;如果项目约定返回失败结果,也可以采用另一种策略,但所有实现必须一致,不能有的静默忽略、有的报错。

让接口保持窄而可演进

不要为了方便把 SetHp、PlayHitAnimation、DropLoot 都塞进 IDamageReceiver。这会让木箱、护盾、角色被迫实现并不拥有的职责,也让一个调用点同时依赖生命状态、表现和奖励逻辑。攻击只提交伤害意图并处理 DamageResult;动画、音效与掉落可以由各自系统响应经过确认的结果。

如果以后要支持伤害类型、来源标识或抗性,先明确哪些信息所有接收者都需要,再考虑用独立的请求数据结构扩展契约,而不是在接口方法上不断追加零散参数。修改公共契约前,用普通生命、无敌目标和已经归零的对象做回归验证,才能让“可替换”不止停留在编译通过。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计稳定的组件接口

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

登录哪都通