游戏引擎 / 系统课时

用 private 和 readonly 控制状态

用 private 和 readonly 控制状态

组件之外的代码若能直接覆盖分数,保存与显示就很难保持一致。本节用 private 收拢修改入口,用 readonly 表达创建后不应改变的标识,再通过快照返回数据,说明这些限制在哪些边界有效,哪些运行时保护仍需另行实现。

学习目标

  • 用 private 限制类型检查中的成员访问。
  • 用 readonly 表达字段赋值约束。
  • 返回独立快照,避免泄漏可变内部对象。

约束调用方式而非防止攻击

private 让 TypeScript 调用方不能直接访问成员,促使修改经过方法;readonly 限制初始化之后的重新赋值。两者主要是静态检查约束,编译为 JavaScript 后不提供可靠的运行时隔离,也不适合保护口令或反作弊数据。

readonly 对对象属性的约束通常是浅层的,不能推导出整个对象树都不可变。const 也只固定变量绑定。实际需求应先明确:是避免普通代码误改、避免外部持有同一可变对象,还是需要运行时冻结?这些目标需要不同实现。

关闭绕过方法的修改入口

文件:main.ts,完整纯 TypeScript 主例程。

ts
export {};
class ScoreBook {
    private points = 0;
    constructor(readonly playerId: string) {}
    add(amount: number): void {
        // 修改入口维护“只接受非负整数”的规则。
        if (!Number.isInteger(amount) || amount < 0) throw new Error('invalid points');
        this.points += amount;
    }
    snapshot(): { playerId: string; points: number } {
        // 返回新对象,外部修改不会回写内部字段。
        return { playerId: this.playerId, points: this.points };
    }
}
const book = new ScoreBook('p1');
book.add(10);
const view = book.snapshot();
view.points = 999;
console.log(`${view.points}|${book.snapshot().points}`);
console.log(book.playerId);

预期输出:

text
999|10
p1

快照允许调用者修改自己持有的数据,但不会污染 ScoreBook。这样显示系统可以格式化或缓存快照,计分系统仍保有唯一修改入口。若返回的是内部对象本身,即使字段声明为 private,外部仍可能经返回值修改其内容。

选择清晰的访问接口

需要读取值时可以提供 getter 或查询方法,不必把全部内部字段改成 public。方法名称应体现业务操作,例如 add,而不是泛化成 setEverything。readonly playerId 说明标识建立后稳定,但构造时也应根据应用需要验证格式,readonly 不会替你验证字符串。

真正需要运行时私有字段时,可研究 JavaScript 的私有字段或闭包;在 Cocos 项目采用前应确认目标环境及引擎构建兼容。本课只使用兼容范围内的 TypeScript 修饰符,不把静态约束升级为运行时安全承诺。

从快照观察封装效果

练习多调用一次 snapshot,比较两个返回对象是否为同一引用,再检查外部改写后内部计分是否稳定。若数据里还有嵌套数组,浅复制不能隔离数组元素,应按真实所有权决定复制范围,避免无目的深拷贝增加成本。

在 Creator Inspector 中展示属性,需要 Cocos 的 property 装饰器信息;访问修饰符与序列化是不同机制。不要因写了 private 就认为场景不会保存该属性。静态与运行时区别依据 TypeScript 成员可见性。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 private 和 readonly 控制状态

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

登录哪都通