mm_expand 2.0.3 → 2.0.5

package/lib/base.js

@@ -8,39 +8,25 @@ require('./global');
  * 基础类
  */
 class Base extends Event {
-  static config = {
-    // 模块名称
-    name: '',
-    // 模块标题
-    title: '',
-    // 模块描述
-    description: '',
-    // 状态, 可选值: 1-启用, 0-禁用
-    state: 1
-  };
-
   /**
-	 * 构造函数
-	 * @param {object} config 配置参数
-	 */
+   * 构造函数
+   * @param {object} config 配置参数
+   */
   constructor(config) {
-    super();
+    super(config);
     /**
-		 * 配置参数
-		 * @type {object}
-		 */
-    this.config = {...this.constructor.config};
+     * 状态
+     * @type {string} - 状态, 可选值: creating, created, initing, inited, loading, loaded, starting, running, stopping, stopped, unloading, unloaded, destroying, destroyed
+     */
+    this.status = 'creating';
 
-    /**
-		 * 状态
-		 * @type {string} - 状态, 可选值: created, initing, starting, running, stopped, destroying, destroyed
-		 */
-    this.status = 'created';
-
-    // 设置配置
-    this.setConfig(config);
     // 初始化监听
     this._initListen();
+    // 设置配置
+    this.setConfig(config);
+
+    // 状态变更为 created 已完成
+    this.status = 'created';
   }
 }
 
@@ -48,10 +34,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}] ${message}`, ...params);
 };
 
 /**
@@ -67,39 +53,11 @@ Base.prototype._initListen = function () {
   this.on('init:after', (ctx) => {
     this.status = 'inited';
   });
-  // 启动
-  this.on('start:before', (ctx) => {
-    status_last = this.status;
-    this.status = 'starting';
-  });
-  this.on('start:success', (ctx) => {
-    this.status = 'running';
-  });
-  this.on('start:error', (ctx) => {
-    this.status = status_last;
-  });
-  // 停止
-  this.on('stop:before', (ctx) => {
-    status_last = this.status;
-    this.status = 'stopping';
-  });
-  this.on('stop:success', (ctx) => {
-    this.status = 'stopped';
-  });
-  this.on('stop:error', (ctx) => {
-    this.status = status_last;
-  });
   // 销毁
   this.on('destroy:before', (ctx) => {
     status_last = this.status;
     this.status = 'destroying';
   });
-  this.on('destroy:check', (ctx) => {
-    if (status_last !== 'stopped') {
-      status_last = this.status;
-      ctx.error = new Error('销毁前必须先停止');
-    }
-  });
   this.on('destroy:success', (ctx) => {
     this.status = 'destroyed';
   });
@@ -122,37 +80,23 @@ 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;
 };
 
-/**
- * 启动
- */
-Base.prototype.start = async function () {
-
-};
-
-/**
- * 停止
- */
-Base.prototype.stop = async function () {
-
-};
-
 /**
  * 销毁
  */
@@ -161,36 +105,23 @@ Base.prototype.destroy = async function () {
 };
 
 /**
- * 重启
- */
-Base.prototype.restart = async function () {
-  await this.do('stop');
-  await this.do('start');
-};
-
-/**
- * 是否运行中
- * @returns {boolean} 是否运行中
- */
-Base.prototype.isRunning = function () {
-  return this.status === 'running';
-};
-
-/**
- * 结束
+ * 事件驱动
+ * @param {string} method 方法名称
+ * @param {...object} params 参数列表
+ * @returns {object} 返回执行上下文对象
  */
-Base.prototype.end = async function () {
-  await this.do('stop');
-  await this.do('destroy');
+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 +133,7 @@ Base.prototype.do = async function (method, ...args) {
 
   let ctx = {
     method,
-    params: args,
+    params,
     result: undefined,
     error: undefined,
     cancelled: false
@@ -215,26 +146,20 @@ Base.prototype.do = async function (method, ...args) {
     }
 
     await this._doExecuteMethod(method, ctx);
-    
-    // 如果执行成功，进行成功处理
-    if (!ctx.error) {
-      await this._doSuccessProcess(method, ctx);
-    }
-    
-    return ctx.result;
   } catch (error) {
     ctx.error = error;
-    this.log('error', `事件驱动执行异常 [${method}]`, error);
-    
+  }
+  if (ctx.error) {
     // 执行错误处理
     await this._doErrorProcess(method, ctx);
-    
-    // 重新抛出错误，让上层能够捕获
-    throw error;
-  } finally {
-    // 无论成功失败，都要执行后处理
-    await this._doAfterProcess(method, ctx);
   }
+  else {
+    // 如果执行成功，进行成功处理
+    await this._doSuccessProcess(method, ctx);
+  }
+  // 无论成功失败，都要执行后处理
+  await this._doAfterProcess(method, ctx);
+  return ctx;
 };
 
 /**
@@ -343,10 +268,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 +279,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 +290,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 +307,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 +322,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 +375,7 @@ Base.prototype.cmd = async function (command, ...args) {
   // 创建执行上下文
   const ctx = {
     command,
-    args,
+    params,
     cmds: [],
     obj: this,
     error: null,
@@ -564,7 +494,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 +547,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 +576,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/event.js

@@ -16,6 +16,10 @@ class Event {
    * @param {object} config 配置参数
    */
   constructor(config) {
+    /**
+     * 配置参数
+     * @type {object} - 配置参数
+     */
     this.config = {
       ...Event.config,
       ...config || {}

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.3",
+	"version": "2.0.5",
 	"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": {