light-h5-core-lib 2.9.0 → 2.9.2

package/common/util/BeizerUtil.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BeizerUtil = void 0;
 /**
- * 贝塞尔曲线运动
+ * 贝塞尔曲线运动工具<b style="color:red">支持多点</b>
  * @author Aonaufly
  */
 var BeizerUtil = /** @class */ (function () {

package/common/util/DateUtil.js

@@ -23,7 +23,7 @@ var DateUtil = /** @class */ (function () {
         return Math.floor(DateUtil.getTargetTimeStamp(date) / 1000);
     };
     /**
-     * 格式化时间(时,分,秒)
+     * 格式化时间(时,分,秒)<b style="color:red">使用 separator分割</b>
      * @param s 秒
      * @param separator 分隔符(default: ":")
      * @param isSingle0 是否补0(default:true)
@@ -63,7 +63,7 @@ var DateUtil = /** @class */ (function () {
         return result;
     };
     /**
-     * 获取下一天的时间(凌晨)秒 存在1ms误差可以忽略不计
+     * 获取下一天的时间(凌晨)秒 存在1ms误差可以忽略不计<b style="color:red">当天时间24:00</b>
      * @param nowSecond 现在的时间秒 ( 服务器的时间(一般))
      * @return 下一天的时间Second
      * */
@@ -71,7 +71,7 @@ var DateUtil = /** @class */ (function () {
         return DateUtil.getTodayAppointTimeStamp(nowSecond, 23, 59, 59, 999);
     };
     /**
-     * 获取今日指定的时间秒, 例如今日20:00
+     * 获取今日指定的时间(秒), 例如今日20:00
      * @param nowSecond 现在的时间秒 ( 服务器的时间(一般))
      * @param hour 指定的小时数 0~23
      * @param minute 指定的分钟数 0~59

package/package.json

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

package/pool/PoolObj.js

@@ -7,24 +7,96 @@ exports.PoolObj = void 0;
  */
 var PoolObj = /** @class */ (function () {
     /**
-     * @param cap 容量(容积)
+     * @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销毁函数
      */
-    function PoolObj(cap) {
+    function PoolObj(cap, initCreateNum, createCallback, clearCallback, destroyCallback) {
         if (cap === void 0) { cap = 5; }
-        this._cap = cap;
+        if (initCreateNum === void 0) { initCreateNum = 0; }
+        if (createCallback === void 0) { createCallback = null; }
+        if (clearCallback === void 0) { clearCallback = null; }
+        if (destroyCallback === void 0) { destroyCallback = null; }
+        this._cap = cap == null ? 5 : cap;
+        this._createCallback = createCallback;
+        this._clearCallback = clearCallback;
+        this._destroyCallback = destroyCallback;
         this._pool = [];
+        this.initCreate(initCreateNum == null ? 0 : initCreateNum);
     }
+    /**
+     * 初始化一些数量的item
+     */
+    PoolObj.prototype.initCreate = function (initCreateNum) {
+        if (initCreateNum <= 0)
+            return;
+        if (!this._createCallback)
+            return;
+        var maxNum = this._cap > 0 ? Math.min(this._cap, initCreateNum) : initCreateNum;
+        for (var i = 0; i < maxNum; i++) {
+            this._pool.push(this._createCallback());
+        }
+    };
+    /**
+     * 放入到对象池
+     * @return 放入到对象池是否成功
+     */
     PoolObj.prototype.put = function (obj) {
-        if (!obj || this._pool.length >= this._cap)
+        if (!obj)
+            return false;
+        if (this._cap > 0 && this._pool.length >= this._cap) {
+            this._destroyCallback && this._destroyCallback(obj);
             return false;
+        }
+        this._clearCallback && this._clearCallback(obj);
         this._pool.push(obj);
         return true;
     };
+    /**
+     * 获得一个Item<br>
+     * <b style="color:green">如果size==0，则自动使用createCallback创建</b><br>
+     * <b style="color:red">⚠️如果size==0 && createCallback==null,则返回null</b>
+     */
     PoolObj.prototype.one = function () {
-        if (this._pool.length == 0)
-            return null;
+        if (this._pool.length == 0) {
+            if (!this._createCallback)
+                return null;
+            return this._createCallback();
+        }
         return this._pool.shift();
     };
+    Object.defineProperty(PoolObj.prototype, "isExistCreateCallback", {
+        /**
+         * 是否存在Item创建方法
+         */
+        get: function () {
+            return this._createCallback != null;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(PoolObj.prototype, "isExistClearCallback", {
+        /**
+         * 是否存在Item的清理函数
+         */
+        get: function () {
+            return this._clearCallback != null;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(PoolObj.prototype, "isExistDestroyCallback", {
+        /**
+         * 是否存在Item的销毁函数
+         */
+        get: function () {
+            return this._destroyCallback != null;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(PoolObj.prototype, "cap", {
         /**
          * 获取容量(容积)
@@ -58,13 +130,10 @@ var PoolObj = /** @class */ (function () {
         var obj;
         for (var i = 0, j = this._pool.length; i < j; i++) {
             obj = this._pool[i];
-            if (obj.destroy) {
-                obj.destroy();
-            }
-            else if (obj.onDestroy) {
-                obj.onDestroy();
+            if (obj) {
+                this._destroyCallback && this._destroyCallback(obj);
+                obj = null;
             }
-            obj = null;
         }
         this._pool.length = 0;
     };
@@ -72,6 +141,9 @@ var PoolObj = /** @class */ (function () {
         if (!isCleared) {
             this.clear();
         }
+        this._createCallback = null;
+        this._clearCallback = null;
+        this._destroyCallback = null;
         this._pool && (this._pool = null);
     };
     return PoolObj;

package/type/index.d.ts

@@ -13,12 +13,44 @@ export interface IClear extends IDestroy {
 export declare class PoolObj<T> implements IClear {
 	private _pool;
 	private _cap;
+	private _createCallback;
+	private _clearCallback;
+	private _destroyCallback;
 	/**
-	 * @param cap 容量(容积)
+	 * @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销毁函数
+	 */
+	constructor(cap?: number, initCreateNum?: number, createCallback?: () => T, clearCallback?: (item: T) => void, destroyCallback?: (item: T) => void);
+	/**
+	 * 初始化一些数量的item
+	 */
+	private initCreate;
+	/**
+	 * 放入到对象池
+	 * @return 放入到对象池是否成功
 	 */
-	constructor(cap?: number);
 	put(obj: T): boolean;
+	/**
+	 * 获得一个Item<br>
+	 * <b style="color:green">如果size==0，则自动使用createCallback创建</b><br>
+	 * <b style="color:red">⚠️如果size==0 && createCallback==null,则返回null</b>
+	 */
 	one(): T;
+	/**
+	 * 是否存在Item创建方法
+	 */
+	get isExistCreateCallback(): boolean;
+	/**
+	 * 是否存在Item的清理函数
+	 */
+	get isExistClearCallback(): boolean;
+	/**
+	 * 是否存在Item的销毁函数
+	 */
+	get isExistDestroyCallback(): boolean;
 	/**
 	 * 获取容量(容积)
 	 */
@@ -81,7 +113,7 @@ export declare class DateUtil {
 	 */
 	static getTargetSeconds(date: string): number;
 	/**
-	 * 格式化时间(时,分,秒)
+	 * 格式化时间(时,分,秒)<b style="color:red">使用 separator分割</b>
 	 * @param s 秒
 	 * @param separator 分隔符(default: ":")
 	 * @param isSingle0 是否补0(default:true)
@@ -96,13 +128,13 @@ export declare class DateUtil {
 	 */
 	static format_MS(s: number, separator?: string, isSingle0?: boolean): string;
 	/**
-	 * 获取下一天的时间(凌晨)秒 存在1ms误差可以忽略不计
+	 * 获取下一天的时间(凌晨)秒 存在1ms误差可以忽略不计<b style="color:red">当天时间24:00</b>
 	 * @param nowSecond 现在的时间秒 ( 服务器的时间(一般))
 	 * @return 下一天的时间Second
 	 * */
 	static getNextDayTimeStamp(nowSecond: number): number;
 	/**
-	 * 获取今日指定的时间秒, 例如今日20:00
+	 * 获取今日指定的时间(秒), 例如今日20:00
 	 * @param nowSecond 现在的时间秒 ( 服务器的时间(一般))
 	 * @param hour 指定的小时数 0~23
 	 * @param minute 指定的分钟数 0~59
@@ -229,7 +261,7 @@ export declare class UniqueIDUtil {
 	static getCompositeKey(key: string | number, uniqueId: string): string;
 }
 /**
- * 贝塞尔曲线运动
+ * 贝塞尔曲线运动工具<b style="color:red">支持多点</b>
  * @author Aonaufly
  */
 export declare class BeizerUtil {