mm_sqlite 1.5.1 → 1.5.3

package/index.js

@@ -173,6 +173,7 @@ SQLite.prototype.run = async function (sql, params = [], timeout = 30000) {
     throw new TypeError('timeout must be number');
   }
 
+  // 注意：同 scope 下为单例共享，this.error/this.sql 并发时以最后一次写入为准
   this.error = null;
   this.sql = '';
   let conn = null;
@@ -219,6 +220,7 @@ SQLite.prototype.exec = async function (sql, params = [], timeout) {
     throw new TypeError('timeout must be number');
   }
 
+  // 注意：同 scope 下为单例共享，this.error/this.sql 并发时以最后一次写入为准
   this.error = null;
   this.sql = '';
   let conn = null;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_sqlite",
-    "version": "1.5.1",
+    "version": "1.5.3",
     "description": "高性能SQLite数据库操作模块，提供与mm_mysql完全兼容的API接口，支持异步操作、事务处理和批量操作",
     "main": "index.js",
     "scripts": {
@@ -39,12 +39,12 @@
     },
     "dependencies": {
         "better-sqlite3": "^13.0.3",
-        "mm_expand": "^2.5.1",
+        "mm_expand": "^2.5.3",
         "sqlstring": "^2.3.3"
     },
     "devDependencies": {
         "eslint": "^10.8.1",
-        "eslint-plugin-jsdoc": "^64.0.1",
-        "mm_eslint": "^1.7.5"
+        "eslint-plugin-jsdoc": "^64.2.0",
+        "mm_eslint": "^1.7.6"
     }
 }

package/sql.js

@@ -66,7 +66,7 @@ class Sql extends Base {
     }
   };
   /**
-   * @description 数据库管理器
+   * 数据库管理器
    * @param {Function} run 查询函数
    * @param {Function} exec 更改函数
    */
@@ -153,7 +153,7 @@ class Sql extends Base {
 }
 
 /**
- * @description 清空查询条件
+ * 清空查询条件
  * @returns {object} 返回当前对象
  */
 Sql.prototype.clear = function () {
@@ -171,7 +171,7 @@ Sql.prototype.clear = function () {
 };
 
 /**
- * @description 过滤查询参数
+ * 过滤查询参数
  * @param {object} query 查询参数
  */
 Sql.prototype.filter = function (query) {
@@ -245,7 +245,7 @@ Sql.prototype.setSql = function (where, set) {
   return this.exec(sql);
 };
 /**
- * @description 查询数据
+ * 查询数据
  * @param {string} where 查询条件
  * @param {string} sort 排序
  * @param {string} view 显示的字段
@@ -257,7 +257,7 @@ Sql.prototype.getSql = function (where, sort, view) {
 };
 
 /**
- * @description 添加或修改
+ * 添加或修改
  * @param {string} where 查询条件
  * @param {string} set 修改的键值
  * @returns {Promise | object} 执行结果
@@ -285,7 +285,7 @@ Sql.prototype.addOrSetSql = async function (where, set) {
 };
 
 /**
- * @description 查询符合结果总数
+ * 查询符合结果总数
  * @param {string} where 查询条件
  * @returns {Promise | number} 返回结果总数
  */
@@ -303,7 +303,7 @@ Sql.prototype.countSql = async function (where) {
 };
 
 /**
- * @description 查询数据并返回符合条件总数
+ * 查询数据并返回符合条件总数
  * @param {string} where 查询条件
  * @param {string} sort 排序
  * @param {string} view 返回的字段
@@ -323,7 +323,7 @@ Sql.prototype.getCountSql = async function (where, sort, view) {
 };
 
 /**
- * @description 统计学
+ * 统计学
  * @param {string} where 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -366,7 +366,7 @@ Sql.prototype.groupMathSql = async function (where, groupby, view, sort, method)
 
 
 /**
- * @description 分组求平均值
+ * 分组求平均值
  * @param {string} where 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -378,7 +378,7 @@ Sql.prototype.groupAvgSql = async function (where, groupby, view, sort = '') {
 };
 
 /**
- * @description 分组合计数值
+ * 分组合计数值
  * @param {string} where 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -390,7 +390,7 @@ Sql.prototype.groupSumSql = async function (where, groupby, view, sort = '') {
 };
 
 /**
- * @description 分组合计不同条数
+ * 分组合计不同条数
  * @param {string} where 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -403,7 +403,7 @@ Sql.prototype.groupCountSql = async function (where, groupby, view, sort = '') {
 
 
 /**
- * @description 统计学
+ * 统计学
  * @param {object} query 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -417,7 +417,7 @@ Sql.prototype.groupMath = async function (query, groupby, view, sort, method) {
 };
 
 /**
- * @description 分组求平均值
+ * 分组求平均值
  * @param {object} query 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -429,7 +429,7 @@ Sql.prototype.groupAvg = async function (query, groupby, view, sort) {
 };
 
 /**
- * @description 分组合计数值
+ * 分组合计数值
  * @param {object} query 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -441,7 +441,7 @@ Sql.prototype.groupSum = async function (query, groupby, view, sort) {
 };
 
 /**
- * @description 分组合计不同条数
+ * 分组合计不同条数
  * @param {object} query 查询条件
  * @param {string} groupby 分组的字段
  * @param {string} view 返回的字段
@@ -454,7 +454,7 @@ Sql.prototype.groupCount = async function (query, groupby, view, sort) {
 
 /* ===  聚合函数  === */
 /**
- * @description 求和函数
+ * 求和函数
  * @param {string} field 字段名
  * @param {object} query 查询条件
  * @returns {number} 求和结果
@@ -474,7 +474,7 @@ Sql.prototype.sum = async function (field, query) {
 };
 
 /**
- * @description 最大值函数
+ * 最大值函数
  * @param {string} field 字段名
  * @param {object} query 查询条件
  * @returns {number} 最大值结果
@@ -494,7 +494,7 @@ Sql.prototype.max = async function (field, query) {
 };
 
 /**
- * @description 最小值函数
+ * 最小值函数
  * @param {string} field 字段名
  * @param {object} query 查询条件
  * @returns {number} 最小值结果
@@ -514,7 +514,7 @@ Sql.prototype.min = async function (field, query) {
 };
 
 /**
- * @description 平均值函数
+ * 平均值函数
  * @param {string} field 字段名
  * @param {object} query 查询条件
  * @returns {number} 平均值结果
@@ -535,7 +535,7 @@ Sql.prototype.avg = async function (field, query) {
 
 /* ===  字符串操作函数  === */
 /**
- * @description 字符串连接函数
+ * 字符串连接函数
  * @param {...string} args 要连接的字符串参数
  * @returns {string} 连接后的字符串
  */
@@ -551,7 +551,7 @@ Sql.prototype.toStr = function (...args) {
 
 /* ===  备份恢复函数  === */
 /**
- * @description 备份数据库到 SQL 文件
+ * 备份数据库到 SQL 文件
  * @param {string} file 备份文件路径
  * @returns {Promise<boolean>} 备份是否成功
  */
@@ -601,7 +601,7 @@ Sql.prototype.backup = async function (file) {
 };
 
 /**
- * @description 从 SQL 文件恢复数据库
+ * 从 SQL 文件恢复数据库
  * @param {string} file 恢复文件路径
  * @returns {Promise<boolean>} 恢复是否成功
  */
@@ -645,7 +645,7 @@ Sql.prototype.restore = async function (file) {
 };
 
 /**
- * @description 解析 SQL 语句，正确处理字符串中的分号
+ * 解析 SQL 语句，正确处理字符串中的分号
  * @param {string} sql SQL 内容
  * @returns {string[]} SQL 语句数组
  * @private
@@ -692,7 +692,7 @@ Sql.prototype._parseSqlStatements = function (sql) {
 
 /* ===  sql语句拼接函数  === */
 /**
- * @description 转为where语句
+ * 转为where语句
  * @param {object} obj 用作拼接的对象
  * @param {boolean} like 是否使用like匹配, 默认不使用
  * @returns {string} where格式sql语句字符串
@@ -759,7 +759,7 @@ Sql.prototype.toWhere = function (obj, like) {
 };
 
 /**
- * @description 转为set语句
+ * 转为set语句
  * @param {object} obj 用作拼接的对象
  * @returns {string} set格式sql语句字符串
  */
@@ -847,7 +847,7 @@ Sql.prototype.toSetSql = function (query, item, like) {
 };
 
 /**
- * @description 转查询sql语句
+ * 转查询sql语句
  * @param {object} query 查询键值集合
  * @param {string} sort 排序规则
  * @param {string} view 显示的字段
@@ -860,7 +860,7 @@ Sql.prototype.toGetSql = function (query, sort, view, like) {
 };
 /* ===  传入对象操作  === */
 /**
- * @description 增加数据
+ * 增加数据
  * @param {object} body 添加的对象
  * @returns {Promise | object} 执行结果
  */
@@ -875,7 +875,7 @@ Sql.prototype.add = async function (body) {
   return bl;
 };
 /**
- * @description 删除数据
+ * 删除数据
  * @param {object} query 查询条件集合
  * @param {boolean} like 是否使用like匹配, 为空使用默认方式
  * @returns {Promise | object} 执行结果
@@ -891,7 +891,7 @@ Sql.prototype.del = async function (query, like) {
 };
 
 /**
- * @description 修改数据
+ * 修改数据
  * @param {object} query 查询条件集合
  * @param {object} body 修改的键值集合
  * @param {boolean} like 是否使用like匹配, 为空使用默认方式
@@ -908,7 +908,7 @@ Sql.prototype.set = async function (query, body, like) {
 };
 
 /**
- * @description 查询数据（优化版）
+ * 查询数据（优化版）
  * @param {object} query 查询条件
  * @param {string} sort 排序
  * @param {string} view 返回的字段
@@ -982,6 +982,25 @@ Sql.prototype.addOrSet = async function (where, set, like) {
   }
 };
 
+/**
+ * 查询数据（优化版）
+ * @param {object} query 查询条件
+ * @param {string} sort 排序
+ * @param {string} view 返回的字段
+ * @param {boolean} like 是否使用like匹配, 为空使用默认方式
+ * @param {number} timeout 超时时间（毫秒），默认5000ms
+ * @returns {Promise|Array} 查询结果
+ */
+Sql.prototype.list = async function (query, sort, view, like, timeout = 20000) {
+  if (!this.table) {
+    throw new Error('表名未设置');
+  }
+
+  var sql = this.toGetSql(query, sort, view, like);
+  var list = await this.run(sql, [], timeout);
+  return list;
+};
+
 /**
  * 统计记录数
  * @param {object} query 查询条件
@@ -1605,7 +1624,7 @@ Sql.prototype._splitSqlStatements = function (sql_content) {
 };
 
 /**
- * @description 获取创建表的 SQL 语句
+ * 获取创建表的 SQL 语句
  * @returns {Promise<string>} 创建表的 SQL 语句
  * @private
  */
@@ -1627,7 +1646,7 @@ Sql.prototype._getCreateTableSql = async function () {
 };
 
 /**
- * @description 备份数据库到 SQL 文件
+ * 备份数据库到 SQL 文件
  * @param {string} file 备份文件路径
  * @param {boolean} create 是否导出创建表语句，默认为false
  * @returns {Promise<boolean>} 备份是否成功
@@ -1686,7 +1705,7 @@ Sql.prototype.backup = async function (file, create = false) {
 };
 
 /**
- * @description 从 SQL 文件恢复数据库
+ * 从 SQL 文件恢复数据库
  * @param {string} file 备份文件路径
  * @returns {Promise<boolean>} 恢复是否成功
  */
@@ -1722,7 +1741,7 @@ Sql.prototype.restore = async function (file) {
 };
 
 /**
- * @description 解析 SQL 语句
+ * 解析 SQL 语句
  * @param {string} sql SQL 内容
  * @returns {string[]} SQL 语句数组
  * @private