游戏引擎 / 系统课时
让服务对象承担跨组件职责
让服务对象承担跨组件职责
计分、保存和显示分别散在多个组件时,同一次加分可能被保存两次,场景重开又可能意外清零。本节用一个独立计分服务拥有状态,通过存储接口完成保存,让组件共享同一个服务实例,并明确重置、失败与存活范围。
学习目标
- 由服务统一拥有跨组件状态与修改入口。
- 用小型接口隔离具体存储实现。
- 处理保存失败,明确服务何时创建和重置。
状态只能有明确的所有者
两个组件同时需要分数,不代表各自创建一份服务。输入组件负责发起加分,显示组件读取快照,存档入口请求保存,它们应引用同一个 ScoreService 实例。服务维护规则,组件维护引擎引用和生命周期,两层职责不应互相反向导入。
本例通过构造参数传入存储接口,服务不关心存到内存、文件还是平台 API。保存失败不会丢失当前内存分数,调用者收到失败结果后可以重试。自动回滚是否需要,应由业务决定,不能因为保存异常就擅自把玩家已获得的分数清零。

用接口传入保存能力
文件:service.ts,完整纯 TypeScript 模块。
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。
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; });预期输出:
saved:30
save failed
memory:35|stored:30
0决定服务存活范围
服务可以由一个场景协调者创建,再通过显式初始化传给组件;也可以按项目需求放在长期存活的上下文中。模块顶层单例容易使用,但重开场景未必重置模块状态。必须明确新一局调用 reset,还是每局创建新服务,避免把偶然模块生命周期当作规则。
若服务提供订阅,组件停用时仍要解除监听。服务长期存活不意味着场景节点也长期有效,不能把旧 Label 引用存进服务。保存接口也应把平台异常转换为可识别结果,必要时保留原因供日志使用,而不是向用户展示内部堆栈。
服务初始化应发生在组件开始使用之前,可以由一个协调入口显式传递依赖。未注入服务时应报告配置错误并退出,不要让每个组件临时创建备用服务,否则正常路径和失败路径会悄悄产生不同的状态所有者。
标明最小例程的边界
本例没有真实平台存储,只验证服务所有权、保存成功、保存失败和重置。多次异步保存还可能出现旧写入后完成覆盖新写入的问题,应根据需求选择串行写入、版本控制或服务端校验。单个快照能说明写的内容,但不会自动保障并发写入顺序。
练习让保存失败后恢复 store.fail 并重试,确认可保存当前 35 分。服务的目标是把规则集中到一个可信入口,使组件之间的数据关系更容易检查。接口与类实现规则见 TypeScript Classes。