@esengine/ecs-framework 2.2.21 → 2.3.0

package/bin/Utils/Pool/Pool.js

@@ -0,0 +1,238 @@
+/**
+ * 高性能通用对象池
+ * 支持任意类型的对象池化，包含详细的统计信息
+ */
+export class Pool {
+    /**
+     * 构造函数
+     * @param createFn 创建对象的函数
+     * @param maxSize 池的最大大小，默认100
+     * @param estimatedObjectSize 估算的单个对象大小（字节），默认1024
+     */
+    constructor(createFn, maxSize = 100, estimatedObjectSize = 1024) {
+        this._objects = [];
+        this._createFn = createFn;
+        this._maxSize = maxSize;
+        this._objectSize = estimatedObjectSize;
+        this._stats = {
+            size: 0,
+            maxSize,
+            totalCreated: 0,
+            totalObtained: 0,
+            totalReleased: 0,
+            hitRate: 0,
+            estimatedMemoryUsage: 0
+        };
+    }
+    /**
+     * 获取指定类型的对象池
+     * @param type 对象类型
+     * @param maxSize 池的最大大小
+     * @param estimatedObjectSize 估算的单个对象大小
+     * @returns 对象池实例
+     */
+    static getPool(type, maxSize = 100, estimatedObjectSize = 1024) {
+        let pool = this._pools.get(type);
+        if (!pool) {
+            pool = new Pool(() => new type(), maxSize, estimatedObjectSize);
+            this._pools.set(type, pool);
+        }
+        return pool;
+    }
+    /**
+     * 从池中获取对象
+     * @returns 对象实例
+     */
+    obtain() {
+        this._stats.totalObtained++;
+        if (this._objects.length > 0) {
+            const obj = this._objects.pop();
+            this._stats.size--;
+            this._updateHitRate();
+            this._updateMemoryUsage();
+            return obj;
+        }
+        // 池中没有可用对象，创建新对象
+        this._stats.totalCreated++;
+        this._updateHitRate();
+        return this._createFn();
+    }
+    /**
+     * 释放对象回池中
+     * @param obj 要释放的对象
+     */
+    release(obj) {
+        if (!obj)
+            return;
+        this._stats.totalReleased++;
+        // 如果池未满，将对象放回池中
+        if (this._stats.size < this._maxSize) {
+            // 重置对象状态
+            obj.reset();
+            this._objects.push(obj);
+            this._stats.size++;
+            this._updateMemoryUsage();
+        }
+        // 如果池已满，让对象被垃圾回收
+    }
+    /**
+     * 获取池统计信息
+     * @returns 统计信息对象
+     */
+    getStats() {
+        return { ...this._stats };
+    }
+    /**
+     * 清空池
+     */
+    clear() {
+        // 重置所有对象
+        for (const obj of this._objects) {
+            obj.reset();
+        }
+        this._objects.length = 0;
+        this._stats.size = 0;
+        this._updateMemoryUsage();
+    }
+    /**
+     * 压缩池（移除多余的对象）
+     * @param targetSize 目标大小，默认为当前大小的一半
+     */
+    compact(targetSize) {
+        const target = targetSize ?? Math.floor(this._objects.length / 2);
+        while (this._objects.length > target) {
+            const obj = this._objects.pop();
+            if (obj) {
+                obj.reset();
+                this._stats.size--;
+            }
+        }
+        this._updateMemoryUsage();
+    }
+    /**
+     * 预填充池
+     * @param count 预填充的对象数量
+     */
+    prewarm(count) {
+        const actualCount = Math.min(count, this._maxSize - this._objects.length);
+        for (let i = 0; i < actualCount; i++) {
+            const obj = this._createFn();
+            obj.reset();
+            this._objects.push(obj);
+            this._stats.totalCreated++;
+            this._stats.size++;
+        }
+        this._updateMemoryUsage();
+    }
+    /**
+     * 设置最大池大小
+     * @param maxSize 新的最大大小
+     */
+    setMaxSize(maxSize) {
+        this._maxSize = maxSize;
+        this._stats.maxSize = maxSize;
+        // 如果当前池大小超过新的最大值，进行压缩
+        if (this._objects.length > maxSize) {
+            this.compact(maxSize);
+        }
+    }
+    /**
+     * 获取池中可用对象数量
+     * @returns 可用对象数量
+     */
+    getAvailableCount() {
+        return this._objects.length;
+    }
+    /**
+     * 检查池是否为空
+     * @returns 如果池为空返回true
+     */
+    isEmpty() {
+        return this._objects.length === 0;
+    }
+    /**
+     * 检查池是否已满
+     * @returns 如果池已满返回true
+     */
+    isFull() {
+        return this._objects.length >= this._maxSize;
+    }
+    /**
+     * 获取所有已注册的池类型
+     * @returns 所有池类型的数组
+     */
+    static getAllPoolTypes() {
+        return Array.from(this._pools.keys());
+    }
+    /**
+     * 获取所有池的统计信息
+     * @returns 包含所有池统计信息的对象
+     */
+    static getAllPoolStats() {
+        const stats = {};
+        for (const [type, pool] of this._pools) {
+            const typeName = type.name || type.toString();
+            stats[typeName] = pool.getStats();
+        }
+        return stats;
+    }
+    /**
+     * 压缩所有池
+     */
+    static compactAllPools() {
+        for (const pool of this._pools.values()) {
+            pool.compact();
+        }
+    }
+    /**
+     * 清空所有池
+     */
+    static clearAllPools() {
+        for (const pool of this._pools.values()) {
+            pool.clear();
+        }
+        this._pools.clear();
+    }
+    /**
+     * 获取全局池统计信息的格式化字符串
+     * @returns 格式化的统计信息字符串
+     */
+    static getGlobalStatsString() {
+        const stats = this.getAllPoolStats();
+        const lines = ['=== Object Pool Global Statistics ===', ''];
+        if (Object.keys(stats).length === 0) {
+            lines.push('No pools registered');
+            return lines.join('\n');
+        }
+        for (const [typeName, stat] of Object.entries(stats)) {
+            lines.push(`${typeName}:`);
+            lines.push(`  Size: ${stat.size}/${stat.maxSize}`);
+            lines.push(`  Hit Rate: ${(stat.hitRate * 100).toFixed(1)}%`);
+            lines.push(`  Total Created: ${stat.totalCreated}`);
+            lines.push(`  Total Obtained: ${stat.totalObtained}`);
+            lines.push(`  Memory: ${(stat.estimatedMemoryUsage / 1024).toFixed(1)} KB`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 更新命中率
+     */
+    _updateHitRate() {
+        if (this._stats.totalObtained === 0) {
+            this._stats.hitRate = 0;
+        }
+        else {
+            const hits = this._stats.totalObtained - this._stats.totalCreated;
+            this._stats.hitRate = hits / this._stats.totalObtained;
+        }
+    }
+    /**
+     * 更新内存使用估算
+     */
+    _updateMemoryUsage() {
+        this._stats.estimatedMemoryUsage = this._stats.size * this._objectSize;
+    }
+}
+Pool._pools = new Map();
+//# sourceMappingURL=Pool.js.map

package/bin/Utils/Pool/Pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pool.js","sourceRoot":"","sources":["../../../src/Utils/Pool/Pool.ts"],"names":[],"mappings":"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"}

package/bin/Utils/Pool/PoolManager.d.ts

@@ -0,0 +1,96 @@
+import { IPoolable, PoolStats } from './IPoolable';
+import { Pool } from './Pool';
+import type { IService } from '../../Core/ServiceContainer';
+/**
+ * 池管理器
+ * 统一管理所有对象池
+ */
+export declare class PoolManager implements IService {
+    private pools;
+    private autoCompactInterval;
+    private lastCompactTime;
+    constructor();
+    /**
+     * 注册池
+     * @param name 池名称
+     * @param pool 池实例
+     */
+    registerPool<T extends IPoolable>(name: string, pool: Pool<T>): void;
+    /**
+     * 获取池
+     * @param name 池名称
+     * @returns 池实例
+     */
+    getPool<T extends IPoolable>(name: string): Pool<T> | null;
+    /**
+     * 更新池管理器（应在游戏循环中调用）
+     */
+    update(): void;
+    /**
+     * 创建或获取标准池
+     * @param name 池名称
+     * @param createFn 创建函数
+     * @param maxSize 最大大小
+     * @param estimatedObjectSize 估算对象大小
+     * @returns 池实例
+     */
+    createPool<T extends IPoolable>(name: string, createFn: () => T, maxSize?: number, estimatedObjectSize?: number): Pool<T>;
+    /**
+     * 移除池
+     * @param name 池名称
+     * @returns 是否成功移除
+     */
+    removePool(name: string): boolean;
+    /**
+     * 获取所有池名称
+     * @returns 池名称数组
+     */
+    getPoolNames(): string[];
+    /**
+     * 获取池数量
+     * @returns 池数量
+     */
+    getPoolCount(): number;
+    /**
+     * 压缩所有池
+     */
+    compactAllPools(): void;
+    /**
+     * 清空所有池
+     */
+    clearAllPools(): void;
+    /**
+     * 获取所有池的统计信息
+     * @returns 统计信息映射
+     */
+    getAllStats(): Map<string, PoolStats>;
+    /**
+     * 获取总体统计信息
+     * @returns 总体统计信息
+     */
+    getGlobalStats(): PoolStats;
+    /**
+     * 获取格式化的统计信息字符串
+     * @returns 格式化字符串
+     */
+    getStatsString(): string;
+    /**
+     * 设置自动压缩间隔
+     * @param intervalMs 间隔毫秒数
+     */
+    setAutoCompactInterval(intervalMs: number): void;
+    /**
+     * 预填充所有池
+     */
+    prewarmAllPools(): void;
+    /**
+     * 重置池管理器
+     */
+    reset(): void;
+    /**
+     * 释放资源
+     * 实现 IService 接口
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=PoolManager.d.ts.map

package/bin/Utils/Pool/PoolManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolManager.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/PoolManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;GAGG;AACH,qBAAa,WAAY,YAAW,QAAQ;IACxC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,eAAe,CAAK;;IAM5B;;;;OAIG;IACI,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3E;;;;OAIG;IACI,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjE;;OAEG;IACI,MAAM,IAAI,IAAI;IASrB;;;;;;;OAOG;IACI,UAAU,CAAC,CAAC,SAAS,SAAS,EACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,CAAC,EACjB,OAAO,GAAE,MAAY,EACrB,mBAAmB,GAAE,MAAa,GACnC,IAAI,CAAC,CAAC,CAAC;IAYV;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUxC;;;OAGG;IACI,YAAY,IAAI,MAAM,EAAE;IAI/B;;;OAGG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,aAAa,IAAI,IAAI;IAM5B;;;OAGG;IACI,WAAW,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC;IAU5C;;;OAGG;IACI,cAAc,IAAI,SAAS;IA+BlC;;;OAGG;IACI,cAAc,IAAI,MAAM;IA0B/B;;;OAGG;IACI,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIvD;;OAEG;IACI,eAAe,IAAI,IAAI;IAQ9B;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;;OAGG;IACI,OAAO,IAAI,IAAI;CAGzB"}

package/bin/Utils/Pool/PoolManager.js

@@ -0,0 +1,199 @@
+import { Pool } from './Pool';
+/**
+ * 池管理器
+ * 统一管理所有对象池
+ */
+export class PoolManager {
+    constructor() {
+        this.pools = new Map();
+        this.autoCompactInterval = 60000; // 60秒
+        this.lastCompactTime = 0;
+        // 普通构造函数，不再使用单例模式
+    }
+    /**
+     * 注册池
+     * @param name 池名称
+     * @param pool 池实例
+     */
+    registerPool(name, pool) {
+        this.pools.set(name, pool);
+    }
+    /**
+     * 获取池
+     * @param name 池名称
+     * @returns 池实例
+     */
+    getPool(name) {
+        return this.pools.get(name) || null;
+    }
+    /**
+     * 更新池管理器（应在游戏循环中调用）
+     */
+    update() {
+        const now = Date.now();
+        if (now - this.lastCompactTime > this.autoCompactInterval) {
+            this.compactAllPools();
+            this.lastCompactTime = now;
+        }
+    }
+    /**
+     * 创建或获取标准池
+     * @param name 池名称
+     * @param createFn 创建函数
+     * @param maxSize 最大大小
+     * @param estimatedObjectSize 估算对象大小
+     * @returns 池实例
+     */
+    createPool(name, createFn, maxSize = 100, estimatedObjectSize = 1024) {
+        let pool = this.pools.get(name);
+        if (!pool) {
+            pool = new Pool(createFn, maxSize, estimatedObjectSize);
+            this.pools.set(name, pool);
+        }
+        return pool;
+    }
+    /**
+     * 移除池
+     * @param name 池名称
+     * @returns 是否成功移除
+     */
+    removePool(name) {
+        const pool = this.pools.get(name);
+        if (pool) {
+            pool.clear();
+            this.pools.delete(name);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * 获取所有池名称
+     * @returns 池名称数组
+     */
+    getPoolNames() {
+        return Array.from(this.pools.keys());
+    }
+    /**
+     * 获取池数量
+     * @returns 池数量
+     */
+    getPoolCount() {
+        return this.pools.size;
+    }
+    /**
+     * 压缩所有池
+     */
+    compactAllPools() {
+        for (const pool of this.pools.values()) {
+            pool.compact();
+        }
+    }
+    /**
+     * 清空所有池
+     */
+    clearAllPools() {
+        for (const pool of this.pools.values()) {
+            pool.clear();
+        }
+    }
+    /**
+     * 获取所有池的统计信息
+     * @returns 统计信息映射
+     */
+    getAllStats() {
+        const stats = new Map();
+        for (const [name, pool] of this.pools) {
+            stats.set(name, pool.getStats());
+        }
+        return stats;
+    }
+    /**
+     * 获取总体统计信息
+     * @returns 总体统计信息
+     */
+    getGlobalStats() {
+        let totalSize = 0;
+        let totalMaxSize = 0;
+        let totalCreated = 0;
+        let totalObtained = 0;
+        let totalReleased = 0;
+        let totalMemoryUsage = 0;
+        for (const pool of this.pools.values()) {
+            const stats = pool.getStats();
+            totalSize += stats.size;
+            totalMaxSize += stats.maxSize;
+            totalCreated += stats.totalCreated;
+            totalObtained += stats.totalObtained;
+            totalReleased += stats.totalReleased;
+            totalMemoryUsage += stats.estimatedMemoryUsage;
+        }
+        const hitRate = totalObtained === 0 ? 0 : (totalObtained - totalCreated) / totalObtained;
+        return {
+            size: totalSize,
+            maxSize: totalMaxSize,
+            totalCreated,
+            totalObtained,
+            totalReleased,
+            hitRate,
+            estimatedMemoryUsage: totalMemoryUsage
+        };
+    }
+    /**
+     * 获取格式化的统计信息字符串
+     * @returns 格式化字符串
+     */
+    getStatsString() {
+        const lines = ['=== Pool Manager Statistics ===', ''];
+        if (this.pools.size === 0) {
+            lines.push('No pools registered');
+            return lines.join('\n');
+        }
+        const globalStats = this.getGlobalStats();
+        lines.push(`Total Pools: ${this.pools.size}`);
+        lines.push(`Global Hit Rate: ${(globalStats.hitRate * 100).toFixed(1)}%`);
+        lines.push(`Global Memory Usage: ${(globalStats.estimatedMemoryUsage / 1024).toFixed(1)} KB`);
+        lines.push('');
+        for (const [name, pool] of this.pools) {
+            const stats = pool.getStats();
+            lines.push(`${name}:`);
+            lines.push(`  Size: ${stats.size}/${stats.maxSize}`);
+            lines.push(`  Hit Rate: ${(stats.hitRate * 100).toFixed(1)}%`);
+            lines.push(`  Memory: ${(stats.estimatedMemoryUsage / 1024).toFixed(1)} KB`);
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * 设置自动压缩间隔
+     * @param intervalMs 间隔毫秒数
+     */
+    setAutoCompactInterval(intervalMs) {
+        this.autoCompactInterval = intervalMs;
+    }
+    /**
+     * 预填充所有池
+     */
+    prewarmAllPools() {
+        for (const pool of this.pools.values()) {
+            const stats = pool.getStats();
+            const prewarmCount = Math.floor(stats.maxSize * 0.2); // 预填充20%
+            pool.prewarm(prewarmCount);
+        }
+    }
+    /**
+     * 重置池管理器
+     */
+    reset() {
+        this.clearAllPools();
+        this.pools.clear();
+        this.lastCompactTime = 0;
+    }
+    /**
+     * 释放资源
+     * 实现 IService 接口
+     */
+    dispose() {
+        this.reset();
+    }
+}
+//# sourceMappingURL=PoolManager.js.map

package/bin/Utils/Pool/PoolManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolManager.js","sourceRoot":"","sources":["../../../src/Utils/Pool/PoolManager.ts"],"names":[],"mappings":"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"}

package/bin/Utils/Pool/index.d.ts

@@ -0,0 +1,4 @@
+export * from './IPoolable';
+export * from './Pool';
+export * from './PoolManager';
+//# sourceMappingURL=index.d.ts.map

package/bin/Utils/Pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Utils/Pool/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}

package/bin/Utils/Pool/index.js

@@ -0,0 +1,4 @@
+export * from './IPoolable';
+export * from './Pool';
+export * from './PoolManager';
+//# sourceMappingURL=index.js.map

package/bin/Utils/Pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Utils/Pool/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,eAAe,CAAC"}