mm_expand 2.1.2 → 2.1.4

package/index.js

@@ -22,6 +22,9 @@ var { Lang } = require('./lib/lang.js');
 var { Event } = require('./lib/event.js');
 var { Base } = require('./lib/base.js');
 var { Timer } = require('./lib/timer.js');
+var { Errors } = require('./lib/errors.js');
+var { Req } = require('./lib/req.js');
+var { Ret } = require('./lib/ret.js');
 var { Validator, validator } = require('./lib/validator.js');
 
 // 初始化$对象
@@ -78,6 +81,12 @@ module.exports = {
   File,
   // 目录类
   Dir,
+  // 错误类
+  Errors,
+  // 请求类
+  Req,
+  // 响应类
+  Ret,
   // 验证器实例
   validator,
   // 事件驱动实例

package/lib/base.js

@@ -2,12 +2,21 @@ const {
   Event
 } = require('./event.js');
 
-require('./global');
-
 /**
  * 基础类
  */
 class Base extends Event {
+  /**
+   * 配置参数
+   * @type {object}
+   */
+  static config = {};
+  /**
+   * 状态
+   * @type {string} - 状态, 可选值: creating, created, initing, inited, loading, loaded, starting, running, stopping, stopped, unloading, unloaded, destroying, destroyed
+   */
+  #status = 'creating';
+
   /**
    * 构造函数
    * @param {object} config 配置参数
@@ -19,34 +28,36 @@ class Base extends Event {
      * @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';
 
     // 设置配置
     this.setConfig(config);
+    // 监听事件
+    this._listen();
+  }
+  
+  /**
+   * 获取当前状态
+   * @returns {string} 当前状态
+   */
+  getStatus() {
+    return this.#status;
+  }
 
-    // 状态变更为 created 已完成
-    this.status = 'created';
-
-    // 监听初始化事件
-    this._onInit();
-    // 监听销毁事件
-    this._onDestroy();
+  /**
+   * 设置当前状态
+   * @param {string} status 状态
+   */
+  setStatus(status) {
+    this.#status = status;
   }
 }
 
 /**
- * 日志输出
- * @param {string} level 日志级别
- * @param {string} message 日志消息
- * @param  {...any} params 日志参数
+ * 监听事件
  */
-Base.prototype.log = function (level, message, ...params) {
-  this._logger[level](`[${this.constructor.name}] ${message}`, ...params);
+Base.prototype._listen = function () {
+  this._onInit();
+  this._onDestroy();
 };
 
 /**
@@ -55,11 +66,11 @@ Base.prototype.log = function (level, message, ...params) {
 Base.prototype._onInit = function () {
   // 初始化
   this.on('init:before', async (ctx) => {
-    this.status = 'initing';
+    this.setStatus('initing');
     await this._initCore(...ctx.params);
   });
   this.on('init:after', (ctx) => {
-    this.status = 'inited';
+    this.setStatus('inited');
   });
 };
 
@@ -67,23 +78,29 @@ Base.prototype._onInit = function () {
  * 监听销毁事件
  */
 Base.prototype._onDestroy = function () {
-  let status_last = 'created';
+  let status_last = 'stopped';
   // 销毁
   this.on('destroy:before', async (ctx) => {
     status_last = this.status;
-    this.status = 'destroying';
+    this.setStatus('destroying');
   });
   this.on('destroy:after', async (ctx) => {
     await this._destroyCore(...ctx.params);
   });
   this.on('destroy:success', (ctx) => {
-    this.status = 'destroyed';
+    this.setStatus('destroyed');
   });
   this.on('destroy:error', (ctx) => {
-    this.status = status_last;
+    this.setStatus(status_last);
   });
 };
 
+/**
+ * 预设值
+ */
+Base.prototype._preset = function () {
+};
+
 /**
  * 设置配置参数
  * @param {object} config 主要配置
@@ -96,6 +113,16 @@ Base.prototype.setConfig = function (config) {
     }
     Object.assign(this.config, config);
   }
+  // 初始化设置
+  this._preset();
+  return this.config;
+};
+
+/**
+ * 获取当前配置
+ * @returns {Object} 配置对象
+ */
+Base.prototype.getConfig = function () {
   return this.config;
 };
 

package/lib/errors.js

@@ -0,0 +1,160 @@
+const { Base } = require('./base');
+
+/**
+ * @file 错误代码管理类
+ * @class Errors
+ */
+class Errors extends Base {
+  static config = {
+    /**
+     * @description 错误码语言
+     * @type {string}
+     * @default "zh-CN"
+     */
+    lang: "zh-CN"
+  };
+  
+  /**
+   * @description 构造函数
+   * @constructor
+   * @param {Object} config 配置项
+   */
+  constructor(config) {
+    super(config);
+    /**
+     * @description 错误码语言包
+     */
+    this._langs = {
+      "zh-CN": {
+        "10000": "业务逻辑错误",
+        "0": "成功",
+        "100": "继续",
+        "101": "切换协议",
+        "200": "确定",
+        "201": "已创建",
+        "202": "已接受",
+        "204": "无内容",
+        "301": "已永久移动",
+        "302": "已找到",
+        "303": "见其他",
+        "304": "未修改",
+        "307": "临时重定向",
+        "400": "错误请求",
+        "401": "未授权",
+        "403": "禁止访问",
+        "404": "未找到",
+        "405": "方法不允许",
+        "408": "请求超时",
+        "413": "Payload Too Large",
+        "415": "不支持的媒体类型",
+        "429": "请求过多",
+        "500": "内部服务器错误",
+        "501": "未实现",
+        "502": "错误网关",
+        "503": "服务不可用",
+        "504": "网关超时",
+        "-32700": "格式错误",
+        "-32701": "不支持的编码",
+        "-32702": "编码中包含无效字符",
+        "-32600": "无效的json-rpc. 不符合规范",
+        "-32601": "请求的方法未找到",
+        "-32602": "无效的方法参数",
+        "-32603": "内部json-rpc错误",
+        "-32500": "应用错误",
+        "-32400": "系统错误",
+        "-32300": "传输错误",
+        "30000": "身份验证失败",
+        "40000": "数据库执行错误",
+        "50000": "服务端执行错误",
+        "70000": "参数不正确"
+      },
+      "en-US": {
+        "10000": "business logic error",
+        "0": "success",
+        "100": "Continue",
+        "101": "Switching Protocols",
+        "200": "OK",
+        "201": "Created",
+        "202": "Accepted",
+        "204": "No Content",
+        "301": "Moved Permanently",
+        "302": "Found",
+        "303": "See Other",
+        "304": "Not Modified",
+        "307": "Temporary Redirect",
+        "400": "Bad Request",
+        "401": "Unauthorized",
+        "403": "Forbidden",
+        "404": "Not Found",
+        "405": "Method Not Allowed",
+        "408": "Request Timeout",
+        "413": "Payload Too Large",
+        "415": "Unsupported Media Type",
+        "429": "Too Many Requests",
+        "500": "Internal Server Errors",
+        "501": "Not Implemented",
+        "502": "Bad Gateway",
+        "503": "Service Unavailable",
+        "504": "Gateway Timeout",
+        "-32700": "not well formed",
+        "-32701": "unsupported encoding",
+        "-32702": "invalid character for encoding",
+        "-32600": "invalid json-rpc. not conforming to spec",
+        "-32601": "requested method not found",
+        "-32602": "invalid method parameters",
+        "-32603": "internal json-rpc error",
+        "-32500": "application error",
+        "-32400": "system error",
+        "-32300": "transport error",
+        "30000": "authentication failed",
+        "40000": "database execution error",
+        "50000": "server execution error",
+        "70000": "parameter is incorrect"
+      }
+    };
+  }
+}
+
+/**
+ * @description 根据错误码获取错误信息
+ * @param {string|number} code 错误码
+ * @returns {string|null} 错误信息
+ */
+Errors.prototype.get = function (code) {
+  const lang = this._config.lang;
+  const lang_pack = this._langs[lang];
+
+  if (lang_pack && lang_pack[code]) {
+    return lang_pack[code];
+  }
+
+  // 如果当前语言包没有，尝试英文包
+  if (lang !== "en-US" && this._langs["en-US"][code]) {
+    return this._langs["en-US"][code];
+  }
+
+  return null;
+};
+
+/**
+ * @description 设置语言
+ * @param {string} lang 语言代码
+ */
+Errors.prototype.setLang = function (lang) {
+  this._config.lang = lang;
+};
+
+/**
+ * @description 获取当前语言
+ * @returns {string} 当前语言代码
+ */
+Errors.prototype.getLang = function () {
+  return this._config.lang;
+};
+
+/**
+ * @description 导出错误管理类
+ */
+module.exports = {
+  Errors
+}

package/lib/event.js

@@ -11,6 +11,15 @@ class Event {
     error_handler: null
   };
 
+  // 日志对象
+  #logger = $.log || console;
+  // 事件配置
+  #event_config = {};
+  // 事件存储
+  #events = {};
+  // 事件计数器
+  #counters = {};
+
   /**
    * 构造函数
    * @param {object} config 配置参数
@@ -20,13 +29,13 @@ class Event {
      * 配置参数
      * @type {object} - 配置参数
      */
-    this.event_config = {
+    this.#event_config = {
       ...Event.config,
       ...config || {}
     };
 
     // 事件存储结构优化
-    this._events = {
+    this.#events = {
       // 主事件（没有冒号的事件）
       main: new Map(),
       // 特殊事件分类存储
@@ -42,13 +51,10 @@ class Event {
     };
 
     // 事件计数器
-    this._counters = {
+    this.#counters = {
       main: 0,
       special: 0
     };
-
-    // 日志对象
-    this._logger = $.log || console;
   }
 
   /**
@@ -84,13 +90,13 @@ class Event {
 
     if (event_type === 'main') {
       return {
-        map: this._events.main,
+        map: this.#events.main,
         type: 'main'
       };
     }
 
     return {
-      map: this._events.special[event_type],
+      map: this.#events.special[event_type],
       type: 'special',
       special_type: event_type
     };
@@ -116,8 +122,8 @@ class Event {
     const listeners = store.map.get(event_name);
 
     // 检查监听器数量限制
-    if (listeners.length >= this.event_config.max_listeners) {
-      this._logger.warn(`事件 ${event_name} 的监听器数量已达到上限 ${this.event_config.max_listeners}`);
+    if (listeners.length >= this.#event_config.max_listeners) {
+      this.#logger.warn(`事件 ${event_name} 的监听器数量已达到上限 ${this.#event_config.max_listeners}`);
       return this;
     }
 
@@ -125,9 +131,9 @@ class Event {
 
     // 更新计数器
     if (store.type === 'special') {
-      this._counters.special++;
+      this.#counters.special++;
     } else {
-      this._counters.main++;
+      this.#counters.main++;
     }
 
     return this;
@@ -182,9 +188,9 @@ class Event {
 
         // 更新计数器
         if (store.type === 'special') {
-          this._counters.special--;
+          this.#counters.special--;
         } else {
-          this._counters.main--;
+          this.#counters.main--;
         }
       }
     } else {
@@ -194,14 +200,14 @@ class Event {
 
       // 更新计数器
       if (store.type === 'special') {
-        this._counters.special -= count;
+        this.#counters.special -= count;
       } else {
-        this._counters.main -= count;
+        this.#counters.main -= count;
       }
     }
 
     // 自动清理空的事件列表
-    if (this.event_config.auto_clean && listeners && listeners.length === 0) {
+    if (this.#event_config.auto_clean && listeners && listeners.length === 0) {
       store.map.delete(event_name);
     }
 
@@ -409,17 +415,17 @@ class Event {
 
         // 更新计数器
         if (store.type === 'special') {
-          this._counters.special -= count;
+          this.#counters.special -= count;
         } else {
-          this._counters.main -= count;
+          this.#counters.main -= count;
         }
       }
     } else {
       // 移除所有事件
-      this._events.main.clear();
-      Object.values(this._events.special).forEach(map => map.clear());
-      this._counters.main = 0;
-      this._counters.special = 0;
+      this.#events.main.clear();
+      Object.values(this.#events.special).forEach(map => map.clear());
+      this.#counters.main = 0;
+      this.#counters.special = 0;
     }
 
     return this;
@@ -433,12 +439,12 @@ class Event {
     const event_names = [];
 
     // 添加 main 类型事件
-    for (const event_name of this._events.main.keys()) {
+    for (const event_name of this.#events.main.keys()) {
       event_names.push(event_name);
     }
 
     // 添加特殊类型事件
-    for (const [type, map] of Object.entries(this._events.special)) {
+    for (const [type, map] of Object.entries(this.#events.special)) {
       for (const event_name of map.keys()) {
         event_names.push(event_name);
       }
@@ -467,8 +473,8 @@ class Event {
     const listeners = store.map.get(event_name);
 
     // 检查监听器数量限制
-    if (listeners.length >= this.event_config.max_listeners) {
-      this._logger.warn(`事件 ${event_name} 的监听器数量已达到上限 ${this.event_config.max_listeners}`);
+    if (listeners.length >= this.#event_config.max_listeners) {
+      this.#logger.warn(`事件 ${event_name} 的监听器数量已达到上限 ${this.#event_config.max_listeners}`);
       return this;
     }
 
@@ -477,9 +483,9 @@ class Event {
 
     // 更新计数器
     if (store.type === 'special') {
-      this._counters.special++;
+      this.#counters.special++;
     } else {
-      this._counters.main++;
+      this.#counters.main++;
     }
 
     return this;
@@ -522,17 +528,17 @@ class Event {
    */
   getStats() {
     return {
-      total: this._counters.main + this._counters.special,
-      main: this._counters.main,
-      special: this._counters.special,
+      total: this.#counters.main + this.#counters.special,
+      main: this.#counters.main,
+      special: this.#counters.special,
       special_types: {
-        before: this._events.special.before.size,
-        check: this._events.special.check.size,
-        after: this._events.special.after.size,
-        error: this._events.special.error.size,
-        render: this._events.special.render.size,
-        success: this._events.special.success.size,
-        other: this._events.special.other.size
+        before: this.#events.special.before.size,
+        check: this.#events.special.check.size,
+        after: this.#events.special.after.size,
+        error: this.#events.special.error.size,
+        render: this.#events.special.render.size,
+        success: this.#events.special.success.size,
+        other: this.#events.special.other.size
       }
     };
   }
@@ -545,9 +551,9 @@ class Event {
    * @private
    */
   _handleError(error, event_name, args) {
-    if (this.event_config.error_handler) {
+    if (this.#event_config.error_handler) {
       try {
-        this.event_config.error_handler(error, event_name, args);
+        this.#event_config.error_handler(error, event_name, args);
       } catch (handler_error) {
         this._logger.error('错误处理函数执行失败:', handler_error);
       }
@@ -556,15 +562,31 @@ class Event {
     }
   }
 
+  /**
+   * 设置日志记录器
+   * @param {object} logger 日志记录器对象
+   */
+  setLogger(logger) {
+    this.#logger = logger;
+  }
+
+  /**
+   * 获取日志记录器
+   * @returns {object} 日志记录器对象
+   */
+  getLogger() {
+    return this.#logger;
+  }
+
   /**
    * 日志输出
    * @param {string} level 日志级别
    * @param {string} message 日志消息
-   * @param  {...any} args 日志参数
+   * @param  {...any} params 日志参数
    */
-  log(level, message, ...args) {
-    this._logger[level](`[${this.constructor.name}] ${message}`, ...args);
-  }
+  log(level, message, ...params) {
+    this.getLogger()[level](`[${this.constructor.name}] ${message}`, ...params);
+  };
 }
 
 module.exports = {

package/lib/eventer.js

@@ -12,6 +12,10 @@ class Eventer {
     error_handler: null, // 全局错误处理函数
     pause_enabled: true, // 是否启用暂停功能
   };
+  
+  // 日志对象
+  #logger = $.log || console;
+
   /**
    * 构造函数
    * @param {object} config 配置参数
@@ -22,7 +26,7 @@ class Eventer {
       ...config || {}
     };
     // 是否为插件
-    this._is_plugin = false;
+    this.is_plugin = false;
     // 事件字典 - 支持命名空间
     this._dict = {};
     // 事件中间件
@@ -39,20 +43,34 @@ class Eventer {
     this._paused_global = false; // 全局暂停状态
     // 初始化默认命名空间
     this._namespace[this.config.default_namespace] = true;
-    // 日志对象
-    this._logger = $.log || console;
   }
-}
 
-/**
- * 日志输出
- * @param {string} level 日志级别
- * @param {string} message 日志消息
- * @param  {...any} args 日志参数
- */
-Eventer.prototype.log = function (level, message, ...args) {
-  this._logger[level](`[${this.constructor.name}] ${message}`, ...args);
-};
+  /**
+   * 设置日志记录器
+   * @param {object} logger 日志记录器对象
+   */
+  setLogger(logger) {
+    this.#logger = logger;
+  }
+  
+  /**
+   * 获取日志记录器
+   * @returns {object} 日志记录器对象
+   */
+  getLogger() {
+    return this.#logger;
+  }
+
+  /**
+   * 日志输出
+   * @param {string} level 日志级别
+   * @param {string} message 日志消息
+   * @param  {...any} params 日志参数
+   */
+  log(level, message, ...params) {
+    this.getLogger()[level](`[${this.constructor.name}] ${message}`, ...params);
+  };
+}
 
 /**
  * 初始化事件管理器
@@ -180,6 +198,14 @@ Eventer.prototype._createHandlerResult = function (namespace, index, name, full_
   };
 };
 
+/**
+ * 监听事件（支持命名空间和优先级）
+ * @param {string} key 事件关键字，支持namespace:key格式
+ * @param {object} func 触发函数
+ * @param {string} name 增加名称，方便删除，当出现相同名称时会被覆盖
+ * @param {object} options 其他选项，如throttle、debounce、timeout等
+ * @returns {object} 返回事件信息对象 {namespace, index, name, remove}，remove为移除该事件的函数
+ */
 Eventer.prototype.on = function (key, func, name, options) {
   // 处理参数
   const params = this._processOnParams(key, func, name, options);