游戏客户端架构 / 系统课时
设计稳定的组件接口
设计稳定的组件接口
攻击组件若直接读取某个角色脚本的生命值字段,遇到无敌目标、护盾或可破坏物时就得修改调用代码。本课从调用方实际需要的行为出发定义最小接口,再让两种不同实现接入同一攻击逻辑,验证替换时契约不变。
学习目标
- 从使用者需求定义最小接口,而不是暴露实现类的内部状态。
- 为参数、返回值和异常边界写出可验证的行为契约。
- 用两种实现验证调用方无需分辨具体组件类型。
从调用者需要什么开始
攻击方真正需要的是“请求目标承受一次伤害,并知道实际生效多少”,而不是“把某个 Health 对象的 hp 减去一个值”。因此,可以把依赖收窄为 IDamageReceiver:接收正整数伤害请求,返回本次实际扣除量与是否在本次攻击中被击败。
这份契约需要先约定几个细节:请求值必须大于零;实际伤害 Applied 在零与请求量之间;JustDefeated 仅在本次调用令目标从存活转为失效时为真。无敌实现可以返回零,而普通生命组件可以扣血并报告结果。调用方不能依赖目标是否有 _hp 字段。
接口越“全能”,越容易把不相关能力绑在一起。IMovable 不应强制实现受伤或拾取;展示生命条的 UI 也不必获得修改生命值的权限。读取状态、接收命令和发布变化事件,可以根据实际消费者分别设计。
看清依赖方向

依赖方向应该是:攻击组件认识抽象契约,具体生命组件与无敌组件负责实现契约。这样替换目标时,改变的是对象装配,不是攻击流程中的类型判断。接口并不意味着没有依赖,而是把依赖限定为明确、可测试的行为承诺。
运行两种实现验证接口替换
以下完整示例可放入 .NET 8 控制台项目的 Program.cs。同一个 Attack.Strike 先攻击普通生命组件两次,再攻击无敌目标,整个过程中不需要知道具体实现类。
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}");
}
}预期输出:
实际伤害=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;动画、音效与掉落可以由各自系统响应经过确认的结果。
如果以后要支持伤害类型、来源标识或抗性,先明确哪些信息所有接收者都需要,再考虑用独立的请求数据结构扩展契约,而不是在接口方法上不断追加零散参数。修改公共契约前,用普通生命、无敌目标和已经归零的对象做回归验证,才能让“可替换”不止停留在编译通过。