游戏引擎 / 系统课时

让服务对象承担跨组件职责

让服务对象承担跨组件职责

计分、保存和显示分别散在多个组件时,同一次加分可能被保存两次,场景重开又可能意外清零。本节用一个独立计分服务拥有状态,通过存储接口完成保存,让组件共享同一个服务实例,并明确重置、失败与存活范围。

学习目标

  • 由服务统一拥有跨组件状态与修改入口。
  • 用小型接口隔离具体存储实现。
  • 处理保存失败,明确服务何时创建和重置。

状态只能有明确的所有者

两个组件同时需要分数,不代表各自创建一份服务。输入组件负责发起加分,显示组件读取快照,存档入口请求保存,它们应引用同一个 ScoreService 实例。服务维护规则,组件维护引擎引用和生命周期,两层职责不应互相反向导入。

本例通过构造参数传入存储接口,服务不关心存到内存、文件还是平台 API。保存失败不会丢失当前内存分数,调用者收到失败结果后可以重试。自动回滚是否需要,应由业务决定,不能因为保存异常就擅自把玩家已获得的分数清零。

服务共享与存储边界

用接口传入保存能力

文件:service.ts,完整纯 TypeScript 模块。

ts
export interface ScoreStore { write(score: number): Promise<void>; }
export class ScoreService {
    private score = 0;
    constructor(private store: ScoreStore) {}
    add(amount: number): void {
        if (!Number.isInteger(amount) || amount < 0) throw new Error('invalid score');
        this.score += amount;
    }
    current(): number { return this.score; }
    reset(): void { this.score = 0; }
    async save(): Promise<string> {
        // 保存开始时取快照,明确这次写入是哪份数据。
        const snapshot = this.score;
        try { await this.store.write(snapshot); return `saved:${snapshot}`; }
        catch (error: unknown) { return 'save failed'; }
    }
}

服务不自行启动保存,由以下完整入口验证。文件:main.ts。

ts
import { ScoreService, ScoreStore } from './service';
class MemoryStore implements ScoreStore {
    value = 0;
    fail = false;
    async write(score: number): Promise<void> {
        if (this.fail) throw new Error('storage unavailable');
        this.value = score;
    }
}
async function main(): Promise<void> {
    const store = new MemoryStore();
    const service = new ScoreService(store);
    // 两个调用方共同修改同一服务,不创建第二份分数。
    service.add(10); service.add(20);
    console.log(await service.save());
    store.fail = true;
    service.add(5);
    console.log(await service.save());
    console.log(`memory:${service.current()}|stored:${store.value}`);
    service.reset();
    console.log(service.current());
}
void main().catch((error: unknown) => { throw error; });

预期输出:

text
saved:30
save failed
memory:35|stored:30
0

决定服务存活范围

服务可以由一个场景协调者创建,再通过显式初始化传给组件;也可以按项目需求放在长期存活的上下文中。模块顶层单例容易使用,但重开场景未必重置模块状态。必须明确新一局调用 reset,还是每局创建新服务,避免把偶然模块生命周期当作规则。

若服务提供订阅,组件停用时仍要解除监听。服务长期存活不意味着场景节点也长期有效,不能把旧 Label 引用存进服务。保存接口也应把平台异常转换为可识别结果,必要时保留原因供日志使用,而不是向用户展示内部堆栈。

服务初始化应发生在组件开始使用之前,可以由一个协调入口显式传递依赖。未注入服务时应报告配置错误并退出,不要让每个组件临时创建备用服务,否则正常路径和失败路径会悄悄产生不同的状态所有者。

标明最小例程的边界

本例没有真实平台存储,只验证服务所有权、保存成功、保存失败和重置。多次异步保存还可能出现旧写入后完成覆盖新写入的问题,应根据需求选择串行写入、版本控制或服务端校验。单个快照能说明写的内容,但不会自动保障并发写入顺序。

练习让保存失败后恢复 store.fail 并重试,确认可保存当前 35 分。服务的目标是把规则集中到一个可信入口,使组件之间的数据关系更容易检查。接口与类实现规则见 TypeScript Classes。

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

目录与阅读设置

阅读设置

17

记录一个想法

让服务对象承担跨组件职责

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

登录哪都通