light-h5-core-lib 2.10.9 → 2.10.11

package/LightCore.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MapUtil = exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.GetDecorateUtils = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.SetterGetterBase = exports.ClassNameUtil = exports.PoolObj = void 0;
+exports.MapUtil = exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.GetDecorateUtils = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.SetterGetterBase = exports.ClassNameUtil = exports.PoolObj = exports.PoolObjPutStatus = void 0;
 const PoolObj_1 = require("./pool/PoolObj");
 Object.defineProperty(exports, "PoolObj", { enumerable: true, get: function () { return PoolObj_1.PoolObj; } });
 const BaseSingleton_1 = require("./common/base/BaseSingleton");
@@ -44,7 +44,10 @@ const GetDecorateUtils_1 = require("./common/util/GetDecorateUtils");
 Object.defineProperty(exports, "GetDecorateUtils", { enumerable: true, get: function () { return GetDecorateUtils_1.GetDecorateUtils; } });
 const MapUtil_1 = require("./common/util/MapUtil");
 Object.defineProperty(exports, "MapUtil", { enumerable: true, get: function () { return MapUtil_1.MapUtil; } });
+const PoolObjPutStatus_1 = require("./pool/PoolObjPutStatus");
+Object.defineProperty(exports, "PoolObjPutStatus", { enumerable: true, get: function () { return PoolObjPutStatus_1.PoolObjPutStatus; } });
 module.exports = {
+    PoolObjPutStatus: PoolObjPutStatus_1.PoolObjPutStatus,
     PoolObj: PoolObj_1.PoolObj,
     ClassNameUtil: ClassNameUtil_1.ClassNameUtil,
     SetterGetterBase: SetterGetterBase_1.SetterGetterBase,

package/common/util/MapUtil.js

@@ -24,5 +24,57 @@ class MapUtil {
             keyItems = keys.next();
         }
     }
+    /**
+     * 通过Value寻找Key值
+     * @param targetMap 目标Map
+     * @param value 目标值
+     */
+    static getKeyByValue(targetMap, value) {
+        if (!targetMap || targetMap.size <= 0) {
+            return null;
+        }
+        if (!value)
+            return null;
+        const keys = targetMap.keys();
+        let keyItems = keys.next();
+        while (!keyItems.done) {
+            if (targetMap.get(keyItems.value) === value) {
+                return keyItems.value;
+            }
+            keyItems = keys.next();
+        }
+        return null;
+    }
+    /**
+     * 清理字典中的空Value
+     * @param targetMap 目标Map
+     * @param isNeedClearCallback 判断一个值是不是需要被删除 默认：null
+     */
+    static clearEmptyValue(targetMap, isNeedClearCallback = null) {
+        if (!targetMap || targetMap.size <= 0) {
+            return;
+        }
+        const keys = targetMap.keys();
+        let keyItems = keys.next();
+        const deleteKeys = [];
+        let item;
+        while (!keyItems.done) {
+            item = targetMap.get(keyItems.value);
+            if (!item) {
+                deleteKeys.push(keyItems.value);
+            }
+            else if (isNeedClearCallback) {
+                if (isNeedClearCallback(item)) {
+                    deleteKeys.push(keyItems.value);
+                }
+            }
+            keyItems = keys.next();
+        }
+        if (deleteKeys.length <= 0)
+            return;
+        for (let i = 0; i < deleteKeys.length; i++) {
+            targetMap.delete(deleteKeys[i]);
+        }
+    }
 }
 exports.MapUtil = MapUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "light-h5-core-lib",
-  "version": "2.10.9",
+  "version": "2.10.11",
   "description": "light core lib",
   "main": "./LightCore.js",
   "types": "./type/index.d.ts",

package/pool/PoolObj.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PoolObj = void 0;
+const PoolObjPutStatus_1 = require("./PoolObjPutStatus");
 /**
  * 对象池（泛型）</br>
  * 可以防止引用类型二次放入
@@ -8,17 +9,20 @@ exports.PoolObj = void 0;
  */
 class PoolObj {
     /**
-     * @param cap 容量(容积) <b style="color:red">小于等于0：无限容量，慎用</b>
-     * @param initCreateNum 初始化创建数量 <b style="color:red">（createCallback != null 有效）</b>
-     * @param createCallback Item创建函数
-     * @param clearCallback Item清理函数
-     * @param destroyCallback Item销毁函数
+     * @param cap 容量(容积) <b style="color:red">小于等于0：无限容量，慎用</b> 默认：5
+     * @param initCreateNum 初始化创建数量 <b style="color:red">（createCallback != null 有效）</b> 默认： 0
+     * @param createCallback Item创建函数 默认: null
+     * @param clearCallback Item清理函数 默认: null
+     * @param destroyCallback Item销毁函数 默认: null
+     * @param isCanPutCallback Item是否可以被放入到对象池 默认: null
+     * @param isForceRefTypeChecking 如果放入的对象是引用对象，是否要检测重复放入的问题 默认: true
      */
-    constructor(cap = 5, initCreateNum = 0, createCallback = null, clearCallback = null, destroyCallback = null, isForceRefTypeChecking = true) {
+    constructor(cap = 5, initCreateNum = 0, createCallback = null, clearCallback = null, destroyCallback = null, isCanPutCallback = null, isForceRefTypeChecking = true) {
         this._cap = cap == null ? 5 : cap;
         this._createCallback = createCallback;
         this._clearCallback = clearCallback;
         this._destroyCallback = destroyCallback;
+        this._isCanPutCallback = isCanPutCallback;
         this._isForceRefTypeChecking = isForceRefTypeChecking;
         this._pool = [];
         this.initCreate(initCreateNum == null ? 0 : initCreateNum);
@@ -46,14 +50,14 @@ class PoolObj {
     }
     /**
      * 放入到对象池
-     * @return 放入到对象池是否成功
+     * @return 放入到对象池是否成功, PoolObjPutStatus.WARNING_DUPLICATE: 重复放置相同的引用(用户可以据此查找问题)
      */
     put(obj) {
         if (!obj)
-            return false;
+            return PoolObjPutStatus_1.PoolObjPutStatus.FAILED_NULL;
         if (this._cap > 0 && this._pool.length >= this._cap) {
             this._destroyCallback && this._destroyCallback(obj);
-            return false;
+            return PoolObjPutStatus_1.PoolObjPutStatus.FAILED_EXCEEDS_CAPACITY;
         }
         if (this._isForceRefTypeChecking &&
             this._pool.length > 0 &&
@@ -61,13 +65,20 @@ class PoolObj {
             for (let i = 0; i < this._pool.length; i++) {
                 if (this._pool[i] === obj) {
                     //已经放入，无法二次放入
-                    return false;
+                    return PoolObjPutStatus_1.PoolObjPutStatus.WARNING_DUPLICATE;
                 }
             }
         }
+        if (this._isCanPutCallback) {
+            if (!this._isCanPutCallback(obj)) {
+                //client阻止了放入，进行销毁处理
+                this._destroyCallback && this._destroyCallback(obj);
+                return PoolObjPutStatus_1.PoolObjPutStatus.FAILED_CLIENT_PREVENT;
+            }
+        }
         this._clearCallback && this._clearCallback(obj);
         this._pool.push(obj);
-        return true;
+        return PoolObjPutStatus_1.PoolObjPutStatus.SUCCESS;
     }
     /**
      * 获得一个Item<br>

package/pool/PoolObjPutStatus.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolObjPutStatus = void 0;
+/**
+ * 对象池放置的结果状态
+ * @author Aonaufly
+ */
+var PoolObjPutStatus;
+(function (PoolObjPutStatus) {
+    /**成功的*/
+    PoolObjPutStatus[PoolObjPutStatus["SUCCESS"] = 0] = "SUCCESS";
+    /**失败的(item: null)*/
+    PoolObjPutStatus[PoolObjPutStatus["FAILED_NULL"] = 1] = "FAILED_NULL";
+    /**失败的(超过了容量)*/
+    PoolObjPutStatus[PoolObjPutStatus["FAILED_EXCEEDS_CAPACITY"] = 2] = "FAILED_EXCEEDS_CAPACITY";
+    /**⚠️：引用对象重复放入*/
+    PoolObjPutStatus[PoolObjPutStatus["WARNING_DUPLICATE"] = 2] = "WARNING_DUPLICATE";
+    /**⚠️: 客户端阻止了放入*/
+    PoolObjPutStatus[PoolObjPutStatus["FAILED_CLIENT_PREVENT"] = 3] = "FAILED_CLIENT_PREVENT";
+})(PoolObjPutStatus || (exports.PoolObjPutStatus = PoolObjPutStatus = {}));

package/type/index.d.ts

@@ -6,6 +6,22 @@ export interface IDestroy {
 export interface IClear extends IDestroy {
 	clear(): void;
 }
+/**
+ * 对象池放置的结果状态
+ * @author Aonaufly
+ */
+export declare enum PoolObjPutStatus {
+	/**成功的*/
+	SUCCESS = 0,
+	/**失败的(item: null)*/
+	FAILED_NULL = 1,
+	/**失败的(超过了容量)*/
+	FAILED_EXCEEDS_CAPACITY = 2,
+	/**⚠️：引用对象重复放入*/
+	WARNING_DUPLICATE = 2,
+	/**⚠️: 客户端阻止了放入*/
+	FAILED_CLIENT_PREVENT = 3
+}
 /**
  * 对象池（泛型）</br>
  * 可以防止引用类型二次放入
@@ -17,15 +33,18 @@ export declare class PoolObj<T> implements IClear {
 	private _createCallback;
 	private _clearCallback;
 	private _destroyCallback;
+	private _isCanPutCallback;
 	private _isForceRefTypeChecking;
 	/**
-	 * @param cap 容量(容积) <b style="color:red">小于等于0：无限容量，慎用</b>
-	 * @param initCreateNum 初始化创建数量 <b style="color:red">（createCallback != null 有效）</b>
-	 * @param createCallback Item创建函数
-	 * @param clearCallback Item清理函数
-	 * @param destroyCallback Item销毁函数
+	 * @param cap 容量(容积) <b style="color:red">小于等于0：无限容量，慎用</b> 默认：5
+	 * @param initCreateNum 初始化创建数量 <b style="color:red">（createCallback != null 有效）</b> 默认： 0
+	 * @param createCallback Item创建函数 默认: null
+	 * @param clearCallback Item清理函数 默认: null
+	 * @param destroyCallback Item销毁函数 默认: null
+	 * @param isCanPutCallback Item是否可以被放入到对象池 默认: null
+	 * @param isForceRefTypeChecking 如果放入的对象是引用对象，是否要检测重复放入的问题 默认: true
 	 */
-	constructor(cap?: number, initCreateNum?: number, createCallback?: () => T, clearCallback?: (item: T) => void, destroyCallback?: (item: T) => void, isForceRefTypeChecking?: boolean);
+	constructor(cap?: number, initCreateNum?: number, createCallback?: () => T, clearCallback?: (item: T) => void, destroyCallback?: (item: T) => void, isCanPutCallback?: (item: T) => boolean, isForceRefTypeChecking?: boolean);
 	/**
 	 * 初始化一些数量的item
 	 */
@@ -33,9 +52,9 @@ export declare class PoolObj<T> implements IClear {
 	private isObject;
 	/**
 	 * 放入到对象池
-	 * @return 放入到对象池是否成功
+	 * @return 放入到对象池是否成功, PoolObjPutStatus.WARNING_DUPLICATE: 重复放置相同的引用(用户可以据此查找问题)
 	 */
-	put(obj: T): boolean;
+	put(obj: T): PoolObjPutStatus;
 	/**
 	 * 获得一个Item<br>
 	 * <div style="color: #FF0000;">⚠️友情提示：如果有createCallback需要判断是否是New的item则提前使用 this.size == 0保存句柄</div><br>
@@ -561,7 +580,19 @@ export declare class MapUtil {
 	 * @param targetMap 目标Map
 	 * @param everyCallback 每次的回调
 	 */
-	static all(targetMap: Map<any, any>, everyCallback: (key: any, item: any) => void): void;
+	static all<KEY, VALUE>(targetMap: Map<KEY, VALUE>, everyCallback: (key: KEY, item: VALUE) => void): void;
+	/**
+	 * 通过Value寻找Key值
+	 * @param targetMap 目标Map
+	 * @param value 目标值
+	 */
+	static getKeyByValue<KEY, VALUE>(targetMap: Map<KEY, VALUE>, value: VALUE): KEY;
+	/**
+	 * 清理字典中的空Value
+	 * @param targetMap 目标Map
+	 * @param isNeedClearCallback 判断一个值是不是需要被删除 默认：null
+	 */
+	static clearEmptyValue<KEY, VALUE>(targetMap: Map<KEY, VALUE>, isNeedClearCallback?: (item: VALUE) => boolean): void;
 }
 
 export {};