mm_expand 2.0.2 → 2.0.4

package/lib/base.js

@@ -20,27 +20,30 @@ class Base extends Event {
   };
 
   /**
-	 * 构造函数
-	 * @param {object} config 配置参数
-	 */
-  constructor(config) {
+   * 构造函数
+   * @param {object} config 配置参数
+   * @param {object} parent 父模块
+   */
+  constructor(config, parent = null) {
     super();
     /**
-		 * 配置参数
-		 * @type {object}
-		 */
-    this.config = {...this.constructor.config};
+     * 配置参数
+     * @type {object}
+     */
+    this.config = { ...this.constructor.config };
 
     /**
-		 * 状态
-		 * @type {string} - 状态, 可选值: created, initing, starting, running, stopped, destroying, destroyed
-		 */
-    this.status = 'created';
+     * 状态
+     * @type {string} - 状态, 可选值: creating, created, initing, inited, loading, loaded, starting, running, stopping, stopped, unloading, unloaded, destroying, destroyed
+     */
+    this.status = 'creating';
 
     // 设置配置
     this.setConfig(config);
     // 初始化监听
     this._initListen();
+    
+    this.status = 'created';
   }
 }
 
@@ -48,10 +51,10 @@ class Base extends Event {
  * 日志输出
  * @param {string} level 日志级别
  * @param {string} message 日志消息
- * @param  {...any} args 日志参数
+ * @param  {...any} params 日志参数
  */
-Base.prototype.log = function (level, message, ...args) {
-  this._logger[level](`[${this.constructor.name}] [${this.config.name}]  ${message}`, ...args);
+Base.prototype.log = function (level, message, ...params) {
+  this._logger[level](`[${this.constructor.name}] [${this.config.name}]  ${message}`, ...params);
 };
 
 /**
@@ -67,6 +70,14 @@ Base.prototype._initListen = function () {
   this.on('init:after', (ctx) => {
     this.status = 'inited';
   });
+  // 加载
+  this.on('load:before', (ctx) => {
+    status_last = this.status;
+    this.status = 'loading';
+  });
+  this.on('load:after', (ctx) => {
+    this.status = 'loaded';
+  });
   // 启动
   this.on('start:before', (ctx) => {
     status_last = this.status;
@@ -89,6 +100,14 @@ Base.prototype._initListen = function () {
   this.on('stop:error', (ctx) => {
     this.status = status_last;
   });
+  // 卸载
+  this.on('unload:before', (ctx) => {
+    status_last = this.status;
+    this.status = 'unloading';
+  });
+  this.on('unload:after', (ctx) => {
+    this.status = 'unloaded';
+  });
   // 销毁
   this.on('destroy:before', (ctx) => {
     status_last = this.status;
@@ -122,20 +141,20 @@ Base.prototype.setConfig = function (config) {
 
 /**
  * 初始化
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回当前对象
  */
-Base.prototype._initCore = async function (...args) {
+Base.prototype._initCore = async function (...params) {
   this.status = 'init';
   return this;
 };
 
 /**
  * 初始化
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回当前对象
  */
-Base.prototype.init = async function (...args) {
+Base.prototype.init = async function (...params) {
   return this;
 };
 
@@ -184,13 +203,25 @@ Base.prototype.end = async function () {
   await this.do('destroy');
 };
 
+
+/**
+ * 事件驱动
+ * @param {string} method 方法名称
+ * @param {...object} params 参数列表
+ * @returns {object} 返回执行上下文对象
+ */
+Base.prototype.do = async function (method, ...params) {
+  let ctx = await this._do(method, ...params);
+  return ctx.result;
+};
+
 /**
  * 事件驱动
  * @param {string} method 方法名称
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回执行结果
  */
-Base.prototype.do = async function (method, ...args) {
+Base.prototype._do = async function (method, ...params) {
   // 入参校验
   if (!method || typeof method !== 'string') {
     throw new TypeError('方法名必须是非空字符串');
@@ -202,7 +233,7 @@ Base.prototype.do = async function (method, ...args) {
 
   let ctx = {
     method,
-    params: args,
+    params,
     result: undefined,
     error: undefined,
     cancelled: false
@@ -215,26 +246,23 @@ Base.prototype.do = async function (method, ...args) {
     }
 
     await this._doExecuteMethod(method, ctx);
-    
+
     // 如果执行成功，进行成功处理
     if (!ctx.error) {
       await this._doSuccessProcess(method, ctx);
     }
-    
-    return ctx.result;
+
+    // return ctx.result;
   } catch (error) {
     ctx.error = error;
-    this.log('error', `事件驱动执行异常 [${method}]`, error);
-    
+
     // 执行错误处理
     await this._doErrorProcess(method, ctx);
-    
-    // 重新抛出错误，让上层能够捕获
-    throw error;
   } finally {
     // 无论成功失败，都要执行后处理
     await this._doAfterProcess(method, ctx);
   }
+  return ctx;
 };
 
 /**
@@ -343,10 +371,10 @@ Base.prototype._doErrorProcess = async function (method, ctx) {
 /**
  * 快速执行方法
  * @param {string} method 方法名称
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回执行结果
  */
-Base.prototype.doEasy = async function (method, ...args) {
+Base.prototype.doEasy = async function (method, ...params) {
   // 快速检查方法是否存在
   if (!this[method]) {
     throw new Error(`方法${method}不存在`);
@@ -354,7 +382,7 @@ Base.prototype.doEasy = async function (method, ...args) {
 
   try {
     // 直接执行主方法，跳过所有事件处理
-    return await this[method](...args);
+    return await this[method](...params);
   } catch (error) {
     // 简单错误处理
     this.log('error', `快速执行方法${method}出错：`, error);
@@ -365,15 +393,15 @@ Base.prototype.doEasy = async function (method, ...args) {
 /**
  * 智能执行方法（自动选择do或doEasy）
  * @param {string} method 方法名称
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @param {object} options 执行选项
  * @returns {object} 返回执行结果
  */
-Base.prototype.doSmart = async function (method, ...args) {
+Base.prototype.doSmart = async function (method, ...params) {
   // 提取选项参数
   let options = {};
-  if (args.length > 0 && typeof args[args.length - 1] === 'object') {
-    options = args.pop();
+  if (params.length > 0 && typeof params[params.length - 1] === 'object') {
+    options = params.pop();
   }
 
   // 检查是否有监听器
@@ -382,10 +410,10 @@ Base.prototype.doSmart = async function (method, ...args) {
   // 根据选项和监听器情况选择执行方式
   if (options.fast || !has_listeners) {
     // 快速执行：无监听器或明确要求快速
-    return await this.doEasy(method, ...args);
+    return await this.doEasy(method, ...params);
   } else {
     // 完整事件驱动执行
-    return await this.do(method, ...args);
+    return await this.do(method, ...params);
   }
 };
 
@@ -397,45 +425,50 @@ Base.prototype.doSmart = async function (method, ...args) {
  */
 Base.prototype._hasEventListeners = function (method) {
   return this.listenerCount(method + ':before') > 0 ||
-		this.listenerCount(method + ':check') > 0 ||
-		this.listenerCount(method + ':render') > 0 ||
-		this.listenerCount(method + ':after') > 0;
+    this.listenerCount(method + ':check') > 0 ||
+    this.listenerCount(method + ':render') > 0 ||
+    this.listenerCount(method + ':after') > 0;
 };
 
 /**
  * 主要执行方法
- * @param  {...any} args 参数列表
+ * @param  {...any} params 参数列表
  */
-Base.prototype.main = async function (...args) {
-
+Base.prototype.main = async function (...params) {
+  console.log('main', ...params);
+  return null;
 };
 
 /**
- * 执行
- * @param {...object} args 参数列表
+ * 执行主方法
+ * @param {...object} params 参数列表
  * @returns {object} 返回执行结果
  */
-Base.prototype.run = async function (...args) {
-  return await this.do('main', ...args);
+Base.prototype.run = async function (...params) {
+  return await this.do('main', ...params);
 };
 
 /**
  * 执行方法
  * @param {string} method 方法名称
- * @param  {...any} args 参数列表
+ * @param  {...any} params 参数列表
  * @returns 
  */
-Base.prototype.exec = async function (method, ...args) {
-  return await this.do(method, ...args);
+Base.prototype.exec = async function (method, ...params) {
+  const result = await this._do(method, ...params);
+  if (result.error) {
+    throw result.error;
+  }
+  return result;
 };
 
 /**
  * 执行指令(主要)
  * @param {string} command 指令
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回执行结果
  */
-Base.prototype.cmd = async function (command, ...args) {
+Base.prototype.cmd = async function (command, ...params) {
   // 入参校验
   if (!command || typeof command !== 'string') {
     this.log('error', '指令必须是非空字符串');
@@ -445,7 +478,7 @@ Base.prototype.cmd = async function (command, ...args) {
   // 创建执行上下文
   const ctx = {
     command,
-    args,
+    params,
     cmds: [],
     obj: this,
     error: null,
@@ -564,7 +597,7 @@ Base.prototype._cmdHandleFunction = async function (ctx, is_last) {
 
   if (is_last) {
     try {
-      ctx.result = await ctx.obj(...ctx.args);
+      ctx.result = await ctx.obj(...ctx.params);
       return true;
     } catch (error) {
       this.log('error', `执行方法${ctx.command}出错：`, error);
@@ -617,12 +650,12 @@ Base.prototype._cmdHandlePrimitive = function (ctx, is_last) {
 
 /**
  * 帮助(主要)
- * @param {...object} args 参数列表
+ * @param {...object} params 参数列表
  * @returns {object} 返回查询结果
  */
-Base.prototype.help = async function (...args) {
+Base.prototype.help = async function (...params) {
   const ctx = {
-    args,
+    params,
     param: null,
     result: '',
     error: null
@@ -646,8 +679,8 @@ Base.prototype.help = async function (...args) {
  * @private
  */
 Base.prototype._helpProcessArgs = function (ctx) {
-  if (ctx.args.length > 0) {
-    ctx.param = ctx.args[0];
+  if (ctx.params.length > 0) {
+    ctx.param = ctx.params[0];
 
     if (ctx.param !== undefined && ctx.param !== null && typeof ctx.param !== 'string') {
       this.log('warn', 'help参数应为字符串类型，将自动转换');

package/lib/validator.js

@@ -389,7 +389,7 @@ Validator.prototype.notNaN = function (val) {
  * @param {*} val 要验证的值
  * @returns {string} 通过返回空字符串，没通过返回错误信息
  */
-Validator.prototype.not_empty = function (val) {
+Validator.prototype.notEmpty = function (val) {
   let bl = val !== undefined && val !== null && val !== '';
   if (!bl) {
     return `参数必须不是空值，实际值为：${val}`;
@@ -1337,7 +1337,7 @@ Validator.prototype.checkRequired = function (val, rule) {
       return tip;
     }
     if (rule.not_empty) {
-      tip = this.not_empty(val);
+      tip = this.notEmpty(val);
       if (tip) {
         return tip;
       }
@@ -1657,9 +1657,9 @@ Number.prototype.isMax = function (max) {
  * 检查字符串是否为空
  * @returns {boolean} 是否为空
  */
-String.prototype.not_empty = function () {
+String.prototype.notEmpty = function () {
   let str = this + '';
-  let tip = validator.not_empty(str);
+  let tip = validator.notEmpty(str);
   if (tip) {
     throw new TypeError(tip);
   }
@@ -1776,7 +1776,7 @@ String.prototype.isName = function () {
  * 检查数组是否为空
  * @returns {Array} 原始数组对象
  */
-Array.prototype.not_empty = function () {
+Array.prototype.notEmpty = function () {
   if (this.length === 0) {
     throw new TypeError('数组不能为空');
   }
@@ -1810,7 +1810,7 @@ Array.prototype.contains = function (element) {
 };
 
 // Object原型方法 - 设置为不可枚举，避免影响for...in循环
-Object.defineProperty(Object.prototype, 'not_empty', {
+Object.defineProperty(Object.prototype, 'notEmpty', {
   value: function () {
     if (Object.keys(this).length === 0) {
       throw new TypeError('对象不能为空');

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mm_expand",
-	"version": "2.0.2",
+	"version": "2.0.4",
 	"description": "Super Meimei Prototype Function Extension Module - Enhanced operations for string, array, object, date manipulation with error prevention and simplified business logic.",
 	"main": "index.js",
 	"scripts": {
@@ -33,7 +33,7 @@
 	"homepage": "https://gitee.com/qiuwenwu91/mm_expand#readme",
 	"dependencies": {
 		"colors": "^1.4.0",
-		"fast-xml-parser": "^5.5.9",
+		"fast-xml-parser": "^5.5.10",
 		"json5": "^2.2.3",
 		"ncp": "^2.0.0",
 		"pinyinlite": "^1.2.1",