目录— 个文件
⌕
目录加载中…
…/core/objectPool/ObjectBase.ts
1import { Component } from 'cc';
2
3/**
4 * 对象池基类(非Component实现,增强扩展性)
5 */
6export class ObjectBase<T = any> extends Component {
7
8 /** 当前绑定的数据(泛型载体) */
9 protected _data?: T;
10
11 //是否正在被使用
12 private isUsing: boolean = false;
13 public get IsUsing(): boolean {
14 return this.isUsing;
15 }
16
17 // 所属对象池名称
18 public PoolName: string = '';
19
20 /**
21 * 物体被创建的时候
22 * @constructor
23 */
24 public OnCreate():void{
25 // Framework.Log.Log(`对象池物体[${this.node.name}]被创建`);
26 }
27
28 /**
29 * 物体被取出时调用
30 * @constructor
31 */
32 public OnSpawn(): void {
33 // Framework.Log.Log(`对象池物体[${this.node.name}]被取出`);
34 this.isUsing = true;
35 if (this.node) this.node.active = true; // 激活节点
36 }
37
38 /** 设置数据(子类可重写以实现具体刷新逻辑,T 用于泛型类型推断) */
39 public setData(data: T): void {
40 this._data = data;
41 }
42
43 /** 获取当前绑定的数据 */
44 public getData(): T | undefined {
45 return this._data;
46 }
47
48 /**
49 * 物体被回收时调用
50 * @constructor
51 */
52 public OnRecycle(): void {
53 // Framework.Log.Log(`对象池物体[${this.node.name}]被回收`);
54 this._data = undefined;
55 this.isUsing = false;
56 if (this.node) this.node.active = false; // 隐藏节点
57 }
58
59
60 /**
61 * 物体被释放时调用
62 * @constructor
63 */
64 public OnRelease(): void {
65 // Framework.Log.Log(`对象池物体[${this.node.name}]被释放`);
66 this._data = undefined;
67 this.isUsing = false;
68 this.PoolName = '';
69 if (this.node?.isValid) this.node.destroy(); // 销毁节点(核心释放逻辑)
70 }
71
72
73}
讲解73 行
对象池对象基类人工通读
ObjectBase.ts
继承 cc.Component,为池内节点提供创建、取出、回收、释放四个生命周期钩子和泛型数据载体。ObjectPool 通过这些钩子切换节点激活状态并在释放阶段销毁节点,业务子类重写 setData 刷新显示内容。
先看四个生命周期钩子各自对节点和数据做了什么,再看 IsUsing 与 PoolName 如何被对象池用来判断归属。
特殊处理与易错点
- 单例/静态状态isUsing 只由 OnSpawn 置真、OnRecycle 与 OnRelease 置假,对象池靠它判断能否复用;手动修改会破坏池的计数与复用判断。L12
- 设计取出时激活节点,回收时只隐藏节点,释放时才销毁节点,回收与释放是两个不同阶段。L32
- 易错点OnRecycle 会清空 _data,对象被复用前必须重新 setData,否则子类刷新时拿到 undefined。L54
6注释ObjectBase:对象池基类(非Component实现,增强扩展性)
9注释当前绑定的数据(泛型载体)
12属性是否正在被使用,对象池复用时据此筛选空闲对象。
13方法只读返回对象是否正在使用,对象池复用时用它筛选空闲实例。
18属性所属对象池名称,由对象池在创建时写入,回收时校验归属。
24方法对象首次由模板实例化后调用,基类留空,子类可在这里做一次性初始化。
26注释Framework.Log.Log(`对象池物体[${this.node.name}]被创建`);
32方法被取出时把使用中标记置真,并激活节点让它显示在场景里。
34注释Framework.Log.Log(`对象池物体[${this.node.name}]被取出`);
39方法把业务数据存进泛型载体,基类只赋值,子类重写后通常再刷新界面。
44方法返回当前绑定的业务数据,未设置或已回收时为 undefined。
52方法被回收时清空数据、取消使用中标记并隐藏节点,保留实例等待下次复用。
54注释Framework.Log.Log(`对象池物体[${this.node.name}]被回收`);
64方法被释放时清空数据与池名,取消使用中标记并在节点有效时销毁节点。
66注释Framework.Log.Log(`对象池物体[${this.node.name}]被释放`);