找物源码导读Cocos Creator 3.8 · assets/scripts
0%
已读 0 / 424
目录— 个文件
目录加载中…
…/core/base/Singleton.ts
1/**
2 * 通用单例基类,使用泛型支持不同类型的类成为单例
3 * @typeParam T - 具体单例类的类型
4 */
5export abstract class Singleton<T> {
6 // 存储单例实例的静态属性
7 private static _instance: any;
8
9 /**
10 * 构造函数,确保即使使用 new 关键字实例化,也只会返回单例实例
11 */
12 protected constructor() {
13 // 如果单例实例已经存在,直接返回该实例
14 if ((this.constructor as typeof Singleton)._instance) {
15 return (this.constructor as typeof Singleton)._instance;
16 }
17 // 若实例不存在,则将当前实例赋值给静态属性
18 (this.constructor as typeof Singleton)._instance = this;
19 }
20
21 /**
22 * 获取单例实例
23 * @returns 单例实例
24 */
25 public static Instance<T>():T {
26 if (!this._instance) {
27 // 实例化具体的单例类
28 this._instance = new (this as any)();
29 }
30 return this._instance;
31 }
32}
讲解33 行
通用单例基类人工通读

Singleton.ts

用子类构造函数自身作为静态实例容器,第一次调用 Instance 时懒创建并缓存,构造函数里再做一次防重复 new 的兜底。所有管理器都继承它,因此实例创建时机由第一次访问决定,谁先访问谁就先构造。

先看 Instance 的懒创建,再看构造函数里 return 已有实例的写法,最后理解静态字段实际挂在每个子类上。

特殊处理与易错点

5注释Singleton:通用单例基类,使用泛型支持不同类型的类成为单例
7注释存储单例实例的静态属性
12方法读取本子类的静态实例,已有则直接返回旧实例,没有才把当前实例登记为该子类唯一实例。
14注释如果单例实例已经存在,直接返回该实例
18注释若实例不存在,则将当前实例赋值给静态属性
25方法没有缓存时用当前构造函数新建实例并写入静态字段,有缓存则直接返回。
28注释实例化具体的单例类