mm_redis 1.9.9 → 2.0.1

package/README.md

@@ -7,8 +7,8 @@ mm_redis是一个高效的Redis客户端封装库，提供了全面的Redis功
 
 ## 版本信息
 
-- **当前版本**: 1.9.9
-- **更新日期**: 2024-12-22
+- **当前版本**: 2.0.1
+- **更新日期**: 2025-10-14
 - **作者**: 邱文武
 - **NPM**: [https://www.npmjs.com/package/mm_redis](https://www.npmjs.com/package/mm_redis)
 - **GitHub**: [https://gitee.com/qiuwenwu91/mm_redis](https://gitee.com/qiuwenwu91/mm_redis)
@@ -79,6 +79,11 @@ redis.setConfig('./config.json');
 ```
 ## 变更日志
 
+### v2.0.0 (2025-10-14)
+- 移除list_push方法，统一使用addForList方法进行列表添加操作
+- 更新文档，将所有list_push引用替换为addForList
+- 更新文档中的API列表和使用示例
+
 ### v1.9.8 (2024-12-22)
 - 更新文档，完善npm发布所需内容
 - 添加GitHub仓库链接到文档
@@ -136,7 +141,7 @@ await redis.close();
 await redis.setForList('users', ['user1', 'user2', 'user3']);
 
 // 添加元素到列表
-await redis.list_push('users', 'user4');
+await redis.addForList('users', 'user4');
 
 // 获取列表
 const users = await redis.getForList('users');
@@ -291,7 +296,7 @@ redis.on('set_error', (data) => {
 | setrange | setrange_before | setrange_after | setrange_error |
 | clear | clear_before | clear_after | clear_error |
 | setForList | setForList_before | setForList_after | setForList_error |
-| list_push | list_push_before | list_push_after | list_push_error |
+| addForList | addForList_before | addForList_after | addForList_error |
 | clearForList | clearForList_before | clearForList_after | clearForList_error |
 | mset | mset_before | mset_after | mset_error |
 | mget | mget_before | mget_after | mget_error |
@@ -335,7 +340,7 @@ redis.on('set_error', (data) => {
 ### 列表操作
 
 - `setForList(key, value, seconds)`: 设置列表
-- `list_push(key, value)`: 添加元素到列表
+- `addForList(key, value)`: 添加元素到列表
 - `getForList(key, start, end)`: 获取列表
 - `hasForList(key, value)`: 判断列表中是否存在元素
 - `clearForList(key, value)`: 清空列表或重置列表
@@ -423,66 +428,12 @@ redis.on('set_error', (data) => {
 
 ## 版本更新
 
-### 1.9.5 (2024-12-21)
-- 修复hmset和hgetall方法的兼容性问题，确保与Redis客户端v5兼容
-- 移除已废弃的hexists、hkeys和hvals方法，优化API设计
-- 优化mget和mset方法的实现，确保与Redis v5 API完全兼容
-- 更新测试脚本，移除对已废弃方法的调用
-- 更新兼容性表格，确保文档与实际API一致
-- 修复原生Redis API调用中的错误，提升代码稳定性
-- 优化连接池管理，修复潜在的内存泄漏问题
-
-### 1.9.4 (2024-12-20)
-- 优化了配置引入方式，支持对象配置和文件路径配置两种方式
-- 改进了setConfig方法的实现，使用Object.assign替代原来的合并方式
-- 修复了连接池相关的警告信息
-- 增强了错误处理机制
-
-### 1.9.0 (2024-11-20)
-- 适配Redis v4 API，确保与最新版Redis客户端兼容
-- 重写pipeline方法，使用Redis v4推荐的实现方式
-- 优化mget方法，直接使用Redis v4的mGet API
-- 修复集合操作(srem)和有序集合操作(zadd/zrange/zscore/zrank)的兼容性问题
-- 完善测试用例，确保所有功能正常工作
-- 更新依赖版本，优化连接管理
-- 完善事件系统，为incr、decr、incrby、decrby方法添加前置事件(_before)支持
-- 确保所有非查询方法都有完整的_before、_after、_error事件触发机制
-- 更新文档，添加新支持的事件到事件列表中
-- 版本号更新和发布日期更新
-
-### 1.8.1 (2024-10-09)
-- 修复mget方法返回格式问题，确保与原生Redis保持一致
-- 修复mset方法参数验证逻辑，优化批量设置功能
-- 优化Pipeline实现，确保命令正确执行
-- 修复连接池初始化和管理逻辑
-- 修复存储机制，确保数据正确持久化
-- 准备npm发布，优化文档格式和结构
-- 添加npm徽章和下载统计
-
-### 1.8.0 (2024-10-08)
-- 新增集合(Set)操作支持：sadd、srem、sismember、smembers、scard、sinter、sunion、sdiff
-- 新增有序集合(Sorted Set)操作支持：zadd、zrem、zscore、zrank、zrange、zcard、zincrby
-- 新增数值操作支持：incr、decr、incrby、decrby、expire
-- 更新文档，添加新功能的API说明
-- 更新版本号和发布日期
-
-### 1.7.0 (2024-10-07)
-- 统一事件系统的属性命名规范
-- 更新所有方法的事件emit属性，使用统一的key、value、ttl、result等命名
-- 增加事件系统的详细文档
-- 修复部分方法中的拼写错误
-
-### 1.6.0 (2024-01-10)
-- 添加完整的连接池管理功能
-- 新增Pipeline批量操作优化
-- 增加Hash数据类型支持
-- 增强错误处理和日志记录
-- 优化重连机制，实现指数退避策略
-
-### 1.5.0
-- 优化连接管理
-- 完善错误处理
-- 提升代码稳定性
+### 2.0.0 (2025-10-14)
+- 移除list_push方法，统一使用addForList方法进行列表添加操作
+- 更新文档，将所有list_push引用替换为addForList
+- 更新文档中的API列表和使用示例
+- 优化连接池配置管理，统一配置到this.config.pool中
+- 新增连接池配置参数：min_idle、max_idle、idle_timeout
 
 ## 贡献指南
 

package/index.js

@@ -39,17 +39,18 @@ class Redis extends BaseService {
 			// 重试次数
 			"retry_count": 3,
 			// 重试间隔(ms)
-			"retry_delay": 1000
-		};
-		this.setConfig(config);
-		// 连接池配置
-		this.connection_pool = {
-			available: [], // 可用连接数组
-			in_use: new Set(), // 使用中的连接集合
-			config: {
-				max_clients: 10 // 最大连接数
+			"retry_delay": 1000,
+			// 连接池配置
+			"pool": {
+				"max_clients": 100, // 最大连接数
+				"min_idle": 5,      // 最小空闲连接数
+				"max_idle": 20,     // 最大空闲连接数
+				"idle_timeout": 30000 // 空闲超时时间(ms)
 			}
 		};
+		this.setConfig(config);
+		// 初始化连接池
+		this._initPool();
 		// 唯一标识符
 		this.identifier = this.config.host + "/" + this.config.database;
 		// 数据库连接器
@@ -167,28 +168,53 @@ Redis.prototype.message = function(channel, message) {
  * @description 设置配置
  * @param {Object} config 配置对象或配置路径
  */
-// 修复setConfig方法，移除其中的_initPool定义
 Redis.prototype.setConfig = function(config) {
 	let obj = {};
 	if (typeof config === 'string') {
 		obj = config.loadJson(__dirname);
 	} else if (config) {
 		// 合并配置参数
-		Object.assign(this.config, config);
+		if (config.pool) {
+			// 确保连接池配置的合并不会覆盖所有默认值
+			if (!this.config.pool) {
+				this.config.pool = {};
+			}
+			Object.assign(this.config.pool, config.pool);
+			// 删除config中的pool属性，避免后续Object.assign重复处理
+			const configCopy = { ...config };
+			delete configCopy.pool;
+			Object.assign(this.config, configCopy);
+		} else {
+			Object.assign(this.config, config);
+		}
 	} else {
 		return;
 	}
-	// 使用Object.assign替代$.push来合并配置
-	this.config = Object.assign({}, this.config || {}, obj);
-	// 检查是否存在连接池配置，如果没有则使用默认配置
+	
+	// 确保连接池配置存在且包含所有必要字段
 	if (!this.config.pool) {
-		this.config.pool = {
-			max_clients: 10,
-			min_idle: 2,
-			max_idle: 5,
-			idle_timeout: 30000
-		};
+		this.config.pool = {};
+	}
+	
+	// 设置默认连接池配置，只覆盖未定义的字段
+	const defaultPoolConfig = {
+		max_clients: 100,
+		min_idle: 5,
+		max_idle: 20,
+		idle_timeout: 30000
+	};
+	
+	for (const key in defaultPoolConfig) {
+		if (this.config.pool[key] === undefined) {
+			this.config.pool[key] = defaultPoolConfig[key];
+		}
 	}
+	
+	// 如果连接池已经初始化，更新其配置
+	if (this.connection_pool) {
+		this.connection_pool.config = this.config.pool;
+	}
+	
 	// 初始化连接池
 	this._initPool();
 	$.log.debug('[Redis] 配置已更新');
@@ -198,20 +224,25 @@ Redis.prototype.setConfig = function(config) {
 
 // 添加连接池初始化方法
 Redis.prototype._initPool = function() {
+	// 确保连接池配置存在
+	if (!this.config.pool) {
+		this.config.pool = {
+			max_clients: 100,
+			min_idle: 5,
+			max_idle: 20,
+			idle_timeout: 30000
+		};
+	}
+	
 	// 初始化连接池相关属性
 	this.connection_pool = {
 		available: [],
 		in_use: new Set(),
-		config: this.config.pool || {
-			max_clients: 10,
-			min_idle: 2,
-			max_idle: 5,
-			idle_timeout: 30000
-		}
+		config: this.config.pool // 直接引用配置对象，确保同步更新
 	};
 
 	// 记录连接池初始化
-	$.log.debug('[Redis] 连接池已初始化');
+	$.log.debug('[Redis] 连接池已初始化，配置:', this.config.pool);
 };
 
 /**
@@ -1774,87 +1805,6 @@ Redis.prototype.setForList = async function(key, value, seconds) {
 	}
 };
 
-/**
- * @description 数组缓存追加对象
- * @param {String} key 键
- * @param {Object|Array} value 值
- * @return {Promise<Number>} 追加后的数组长度
- */
-Redis.prototype.list_push = async function(key, value) {
-	try {
-		// 触发前置事件，允许修改或阻止操作
-		const beforeEventData = {
-			key,
-			value,
-			cancel: false
-		};
-		this.emit('list_push_before', beforeEventData);
-
-		// 如果事件处理器标记为取消，则返回0
-		if (beforeEventData.cancel) {
-			$.log.debug(`[Redis] list_push操作被事件处理器取消 [${key}]`);
-			return 0;
-		}
-
-		// 使用可能被修改的值
-		let {
-			key: finalKey,
-			value: finalValue
-		} = beforeEventData;
-		let len = 0;
-		let success = true;
-
-		const connection = await this._getConnection();
-		try {
-			finalKey = this.applyPrefix(finalKey);
-
-			if (Array.isArray(finalValue)) {
-				// 添加数组元素
-				if (typeof connection.rPush === 'function') {
-					len = await connection.rPush(finalKey, finalValue);
-				} else if (typeof connection.execute === 'function') {
-					len = await connection.execute('RPUSH', [finalKey, ...finalValue]);
-				} else {
-					$.log.error('[Redis] 连接对象不支持rPush操作');
-					success = false;
-					len = 0;
-				}
-			} else {
-				// 添加单个元素
-				if (typeof connection.rPush === 'function') {
-					len = await connection.rPush(finalKey, finalValue);
-				} else if (typeof connection.execute === 'function') {
-					len = await connection.execute('RPUSH', [finalKey, finalValue]);
-				} else {
-					$.log.error('[Redis] 连接对象不支持rPush操作');
-					success = false;
-					len = 0;
-				}
-			}
-
-			// 触发后置事件
-			this.emit('list_push_after', {
-				key: finalKey,
-				value: finalValue,
-				result: len,
-				success
-			});
-			return len;
-		} finally {
-			this._recycleConnection(connection);
-		}
-	} catch (err) {
-		// 触发错误事件
-		this.emit('list_push_error', {
-			key,
-			value,
-			error: err
-		});
-		$.log.error(`[Redis] 向列表追加元素失败 [${key}]:`, err);
-		return 0;
-	}
-};
-
 /**
  * @description 数组缓存追加对象
  * @param {String} key 键
@@ -2620,7 +2570,6 @@ Redis.prototype._releaseConnection = function(connection) {
 			// 检查是否超过最大空闲连接数
 			if (this.connection_pool.available.length < this.connection_pool.config.max_idle) {
 				this.connection_pool.available.push(connection);
-				$.log.debug('[Redis] 连接已释放回池中:', connection.id);
 			} else {
 				// 否则关闭多余的连接
 				try {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_redis",
-    "version": "1.9.9",
+    "version": "2.0.1",
     "description": "高效的Redis客户端封装库，提供连接池管理、数据类型操作、错误处理和批量操作优化",
     "main": "index.js",
     "scripts": {