游戏客户端架构 / 系统课时
用接口隐藏具体组件实现
用接口隐藏具体组件实现
攻击组件一旦直接读取目标的生命值字段、护甲组件或动画状态,更换一种受击方式就需要修改调用方。本课用最小能力接口隔离攻击与受击实现,装配普通生命值和护甲生命值两种组件,并用实际输出验证替换过程。
学习目标
- 识别具体组件依赖给替换与测试带来的成本。
- 设计具有清晰参数和返回值的受击能力接口。
- 让同一攻击组件调用两种实现,并验证结算结果。
识别具体类型泄漏
假设 AttackComponent 持有某个 Enemy,沿着对象引用找到 HealthComponent,再直接修改 hp。这种写法让攻击方知道目标的内部组成:以后目标改为护甲减伤、无敌状态或可破坏道具,就不得不加入更多类型判断。
真正稳定的需求只有一句:“向目标提交一次伤害,并知道结算结果。”调用方不应决定血量存在哪里,也不应负责播放受击动画。将能力从对象结构中提取出来,才有可能在不修改攻击代码的情况下更换实现。
设计最小受击契约
示例使用 IDamageReceiver 表示“可接收伤害”,只提供 ReceiveDamage(amount)。传入的是本次待结算的非负伤害值,返回 DamageResult,记录实际扣血量和剩余生命值。调用方只根据结果决定是否展示命中数字,不自行读写目标内部字段。

接口宜描述动作,而非暴露完整组件。如果把 hp、护甲、音效播放、动画参数都放进一个接口,调用方仍会依赖大量不相关细节。一个能力接口应允许不同实现独立履行同一约定。
编写并运行两种实现
下面是独立的 C# 示例。创建 .NET 8 控制台项目,把代码放进 Program.cs 即可运行。普通生命值直接扣血;护甲生命值先做固定减伤。攻击组件只保存 IDamageReceiver,完全不知道传入的是哪一种具体类。
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}");
}
}预期输出:
普通目标:扣20,剩40
护甲目标:扣15,剩45两次攻击都传入 20,区别只来自实现内部的护甲计算。将装配时的护甲值 5 改为 25,护甲目标本次应扣 0、剩余 60;AttackComponent 不需要任何修改。这也是测试替身能够替换真实组件的基础。
在装配边界连接依赖
示例在 Main 中选择实现;在游戏引擎中,应由对象创建、生成或初始化流程取得目标的受击能力,再交给攻击模块。这样类型查找发生在装配边界,而不是每次命中时反复沿对象层级搜索。若目标没有该能力,应明确认定其不可受击,避免空引用异常。
接口不能自动解决组件的生命周期。目标销毁、切换场景或重新生成后,旧引用可能失效;持有者需要通过宿主的生命周期规则重新绑定或停止调用。网络游戏还应由权威端负责最终伤害计算,接口本身不等于安全校验。
守住契约边界
示例规定负数伤害抛异常,0 伤害不改变生命值,超量伤害只扣到 0;AppliedDamage 永远是实际扣掉的量。不同实现必须遵循这些共同语义,否则虽然类型兼容,业务结果仍不可替换。
如果只有一个稳定实现,且调用与实现严格封闭在同一模块,额外接口可能只是徒增文件。存在多种受击对象、可替换规则或单元测试替身时,接口的价值才最明显。它解决的是“调用方依赖哪种能力”,不是“其他模块如何获知受击结果”;后者适合事件通知。