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

处理组件缺失与可选依赖

处理组件缺失与可选依赖

角色生成时可能尚未加载音效,攻击目标也可能在执行前消失。若所有依赖都直接解引用,一个缺失对象就可能使整套角色逻辑报错。本课把依赖分成必需、可选和运行期动态三类,并通过装配入口与执行检查控制各自的失败范围。

学习目标

  • 按缺失后果区分必需依赖、可选能力和动态目标。
  • 在装配阶段阻止无效组件进入运行态,同时保留无关能力。
  • 验证可选能力缺席和目标离场时,业务执行仍符合预期。

先确定三类依赖的失败语义

必需依赖决定一个组件能否正确工作。例如攻击必须知道伤害计算规则 DamageRule;缺少它时应拒绝装配 Attack,而不是把错误拖到首次攻击。是否连角色一起拒绝创建,取决于该角色能否合法地没有攻击能力。

可选依赖只影响附加体验。命中反馈 HitFeedback 缺失时可以不播放音效,但已命中的伤害仍应结算。如果某项反馈是玩法判定的必要条件,就不能将其标成可选依赖。

运行期动态依赖随时间出现或消失,例如锁定目标。攻击组件保留一个稳定的 TargetSlot,每次执行读取其中的当前目标;目标退场时由拥有者清空槽位,而不是让攻击组件长期缓存旧敌人实例。

攻击组件必需可选和动态依赖的装配与执行关系

把失败判断放在装配入口

对象装配层负责检查必需依赖,并决定是否把组件挂到宿主上。示例中的 assemble_attack 缺少规则时返回 None 并报告原因,上层可以只禁用攻击,保留移动、生命值等组件;对于必须战斗的敌人,则应把同一错误升级为生成失败。

组件进入运行态后,不应每帧通过全局服务定位器反复查找规则。可选反馈通过空值分支处理,动态目标则在真正执行攻击时读取;这把装配错误与正常的运行期目标缺席区分开了。

用可运行示例覆盖缺失路径

以下示例使用 Python 3.10 或更高版本。伤害规则是必需依赖,命中反馈是可选依赖;TargetSlot.current 由外部在目标出现或离场时更新,攻击每次读取最新值。

python
from dataclasses import dataclass
from typing import Protocol

class DamageRule(Protocol):
    def calculate(self, base: int) -> int: ...

class DamageTarget(Protocol):
    def take_damage(self, amount: int) -> None: ...

class HitFeedback(Protocol):
    def on_hit(self) -> None: ...

class FixedRule:
    def calculate(self, base: int) -> int:
        return base

@dataclass
class TargetSlot:
    current: DamageTarget | None = None

@dataclass
class Enemy:
    hp: int = 30

    def take_damage(self, amount: int) -> None:
        self.hp = max(0, self.hp - amount)
        print(f'敌人 HP={self.hp}')

class ConsoleHit:
    def on_hit(self) -> None:
        print('播放命中音效')

class Attack:
    def __init__(self, rule: DamageRule, slot: TargetSlot,
                 feedback: HitFeedback | None = None) -> None:
        self._rule = rule
        self._slot = slot
        self._feedback = feedback

    def execute(self) -> None:
        # 每次攻击重新读取动态目标,避免缓存过期引用
        target = self._slot.current
        if target is None:
            print('无目标:跳过攻击')
            return
        target.take_damage(self._rule.calculate(10))
        if self._feedback is not None:
            self._feedback.on_hit()

def assemble_attack(rule: DamageRule | None, slot: TargetSlot,
                    feedback: HitFeedback | None = None) -> Attack | None:
    # 必需能力缺失时,仅拒绝装配攻击组件
    if rule is None:
        print('装配失败:攻击缺少 DamageRule')
        return None
    return Attack(rule, slot, feedback)

slot = TargetSlot()
attack = assemble_attack(FixedRule(), slot)
assert attack is not None
attack.execute()
slot.current = Enemy()
attack.execute()
slot.current = None
attack.execute()
with_audio = assemble_attack(FixedRule(), slot, ConsoleHit())
assert with_audio is not None
slot.current = Enemy()
with_audio.execute()
missing = assemble_attack(None, slot)
print(f'攻击组件已跳过:{missing is None}')

预期输出:

text
无目标:跳过攻击
敌人 HP=20
无目标:跳过攻击
敌人 HP=20
播放命中音效
装配失败:攻击缺少 DamageRule
攻击组件已跳过:True

两次成功命中均扣除 10 点生命值;第一种没有音效也不影响伤害。目标为空时不会调用任何受击接口,必需规则缺失时则根本不会创建攻击组件。

处理目标失效与恢复

None 检查只解决槽位为空的问题,并不自动证明对象仍然存活。真正的目标销毁流程应先撤销注册或清空槽位;若使用实体 ID、对象池或跨线程消息,还须校验实体代次和有效性,避免复用对象或迟到事件被误认为旧目标仍在。

需要回归的场景包括无规则、无反馈、无目标、目标退出后重新出现,以及正常命中。对缺失的必需依赖提供可定位的报错,不要用捕获所有异常并继续执行来掩盖真实缺陷。组件失效的处理范围应与业务责任一致,而不是默认摧毁整个游戏对象。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理组件缺失与可选依赖

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

登录哪都通