mm_redis 1.9.3 → 1.9.5

package/README.md

@@ -1,449 +1,466 @@
-# mm_redis
-
-mm_redis是一个高效的Redis客户端封装库，提供了全面的Redis功能支持，包括连接池管理、数据类型操作、错误处理和批量操作优化。
-
-[![npm version](https://badge.fury.io/js/mm_redis.svg)](https://badge.fury.io/js/mm_redis)
-[![npm downloads](https://img.shields.io/npm/dm/mm_redis.svg)](https://www.npmjs.com/package/mm_redis)
-
-## 版本信息
-
-- **当前版本**: 1.9.0
-- **更新日期**: 2024-11-20
-- **作者**: 邱文武
-- **NPM**: [https://www.npmjs.com/package/mm_redis](https://www.npmjs.com/package/mm_redis)
-
-## 功能特性
-
-- 完整的连接池管理，优化并发性能
-- 支持Pipeline批量操作，提升执行效率
-- 支持所有主要Redis数据类型：String、List、Hash、Set、Sorted Set等
-- 自动重连机制，使用指数退避策略
-- 全面的错误处理和日志记录
-- 自动JSON序列化/反序列化
-- 键前缀管理，支持多业务隔离
-- 自动连接管理，无需手动维护连接状态
-- 统一的事件系统，支持操作前后的事件监听
-- 支持数值增减操作
-
-## 安装
-
-```bash
-npm install mm_redis --save
-```
-
-## 基本配置
-
-```javascript
-const Redis = require('mm_redis');
-
-// 创建Redis实例
-const redis = new Redis('default');
-
-// 配置Redis连接
-redis.setConfig({
-    // 服务器地址
-    "host": "localhost",
-    // 端口号
-    "port": 6379,
-    // 密码
-    "password": "",
-    // 数据库
-    "database": 0,
-    // 前缀
-    "prefix": "app:",
-    // 连接超时时间(ms)
-    "connect_timeout": 10000,
-    // 重试次数
-    "retry_count": 3,
-    // 重试间隔(ms)
-    "retry_delay": 1000,
-    // 连接池配置
-    "pool": {
-        "max_clients": 10,      // 最大连接数
-        "min_idle": 2,          // 最小空闲连接数
-        "max_idle": 5,          // 最大空闲连接数
-        "idle_timeout": 30000   // 空闲超时时间(ms)
-    }
-});
-```
-
-## 使用示例
-
-### 基本操作
-
-```javascript
-// 连接Redis
-await redis.open();
-
-// 设置缓存
-await redis.set('user:1', { name: '张三', age: 25 }, 3600);
-
-// 获取缓存
-const user = await redis.get('user:1');
-$.log.debug('[Redis] 获取用户信息:', user);
-
-// 判断键是否存在
-const exists = await redis.has('user:1');
-
-// 删除缓存
-await redis.del('user:1');
-
-// 关闭连接
-await redis.close();
-```
-
-### 列表操作
-
-```javascript
-// 设置列表
-await redis.list_set('users', ['user1', 'user2', 'user3']);
-
-// 添加元素到列表
-await redis.list_push('users', 'user4');
-
-// 获取列表
-const users = await redis.list_get('users');
-$.log.debug('[Redis] 用户列表:', users);
-
-// 获取列表的部分元素
-const partialUsers = await redis.list_get('users', 0, 2);
-
-// 清空列表
-await redis.list_clear('users');
-```
-
-### Hash操作
-
-```javascript
-// 设置哈希字段
-await redis.hset('user:profile:1', 'name', '张三');
-await redis.hset('user:profile:1', 'age', 25);
-
-// 批量设置哈希字段
-await redis.hmset('user:profile:1', {
-    'email': 'zhangsan@example.com',
-    'phone': '13800138000'
-});
-
-// 获取哈希字段
-const name = await redis.hget('user:profile:1', 'name');
-
-// 获取哈希的所有字段和值
-const profile = await redis.hgetall('user:profile:1');
-$.log.debug('[Redis] 用户资料:', profile);
-
-// 获取哈希的所有字段名
-const fields = await redis.hkeys('user:profile:1');
-
-// 获取哈希的所有字段值
-const values = await redis.hvals('user:profile:1');
-
-// 判断哈希字段是否存在
-const hasEmail = await redis.hexists('user:profile:1', 'email');
-
-// 获取哈希字段数量
-const fieldCount = await redis.hlen('user:profile:1');
-
-// 删除哈希字段
-await redis.hdel('user:profile:1', ['email', 'phone']);
-```
-
-### 批量操作
-
-```javascript
-// 批量获取
-const data = await redis.mget(['user:1', 'user:2', 'user:3']);
-$.log.debug('[Redis] 批量获取结果:', data);
-
-// 批量设置
-await redis.mset({
-    'user:4': { name: '李四', age: 30 },
-    'user:5': { name: '王五', age: 35 }
-}, 3600);
-```
-
-### 使用Pipeline优化批量操作
-
-```javascript
-// 创建Pipeline
-const pipeline = redis.pipeline();
-
-// 添加多个命令
-pipeline.set('counter:1', 100);
-pipeline.ttl('counter:1', 3600);
-pipeline.hset('stats:today', 'visits', 500);
-pipeline.hset('stats:today', 'users', 100);
-
-// 执行所有命令
-const results = await pipeline.exec();
-$.log.debug('[Redis] Pipeline执行结果:', results);
-```
-
-### 发布订阅
-
-```javascript
-// 订阅频道
-await redis.subscribe('notifications', async (message) => {
-    $.log.debug('[Redis] 收到通知:', message);
-    // 处理接收到的消息
-});
-
-// 发布消息
-const receivedCount = await redis.publish('notifications', JSON.stringify({ 
-    type: 'info', 
-    content: '系统更新成功' 
-}));
-
-$.log.debug(`[Redis] 消息已发布，${receivedCount}个客户端接收`);
-
-// 取消订阅
-await redis.unsubscribe('notifications');
-```
-
-### 事件系统
-
-mm_redis提供了完善的事件系统，可以监听各种操作的前后事件，用于日志记录、数据修改或操作拦截。
-
-```javascript
-// 监听设置操作前的事件
-redis.on('set_before', (data) => {
-    $.log.debug('[Redis] 设置缓存前:', data);
-    // 可以修改data中的值
-    // data.value = JSON.stringify(data.value);
-    // 可以通过设置data.cancel = true来取消操作
-});
-
-// 监听设置操作后的事件
-redis.on('set_after', (data) => {
-    $.log.debug('[Redis] 设置缓存后:', data);
-    // data包含key, value, ttl, success等信息
-});
-
-// 监听设置操作的错误事件
-redis.on('set_error', (data) => {
-    $.log.error('[Redis] 设置缓存错误:', data);
-    // data包含key, value, ttl, error等信息
-});
-```
-
-#### 事件属性规范
-
-所有事件都遵循统一的属性命名规范：
-
-1. **通用属性**：
-   - `key`: 操作的键名
-   - `value`: 操作的值（替代str、fields、obj等）
-   - `ttl`: 过期时间（替代seconds）
-   - `result`: 操作结果（替代length）
-   - `success`: 操作是否成功
-   - `cancel`: 是否取消操作（仅限前置事件）
-   - `error`: 错误信息（仅限错误事件）
-
-2. **特定属性**：
-   - `deleted`: 删除的键列表（用于del操作）
-   - `index`: 索引位置（用于setrange操作）
-   - `field`: 哈希字段名（用于hset操作）
-
-3. **事件命名模式**：
-   - 前置事件: `${methodName}_before`
-   - 后置事件: `${methodName}_after`
-   - 错误事件: `${methodName}_error`
-
-#### 支持的事件列表
-
-| 操作方法 | 前置事件 | 后置事件 | 错误事件 |
-|---------|---------|---------|--------|
-| set | set_before | set_after | set_error |
-| get | get_before | get_after | get_error |
-| del | del_before | del_after | del_error |
-| add | add_before | add_after | add_error |
-| addInt | addInt_before | addInt_after | addInt_error |
-| addFloat | addFloat_before | addFloat_after | addFloat_error |
-| addStr | addStr_before | addStr_after | addStr_error |
-| setrange | setrange_before | setrange_after | setrange_error |
-| clear | clear_before | clear_after | clear_error |
-| list_set | list_set_before | list_set_after | list_set_error |
-| list_push | list_push_before | list_push_after | list_push_error |
-| list_clear | list_clear_before | list_clear_after | list_clear_error |
-| mset | mset_before | mset_after | mset_error |
-| mget | mget_before | mget_after | mget_error |
-| hset | hset_before | hset_after | hset_error |
-| hmset | hmset_before | hmset_after | hmset_error |
-| hdel | hdel_before | hdel_after | hdel_error |
-| hget | hget_before | hget_after | hget_error |
-| hgetall | hgetall_before | hgetall_after | hgetall_error |
-| incr | incr_before | incr_after | incr_error |
-| decr | decr_before | decr_after | decr_error |
-| incrby | incrby_before | incrby_after | incrby_error |
-| decrby | decrby_before | decrby_after | decrby_error |
-| expire | expire_before | expire_after | expire_error |
-| sadd | sadd_before | sadd_after | sadd_error |
-| srem | srem_before | srem_after | srem_error |
-| zadd | zadd_before | zadd_after | zadd_error |
-
-## API文档
-
-### 连接管理
-
-- `setConfig(config)`: 设置Redis配置
-- `open()`: 连接Redis
-- `close()`: 关闭连接
-- `isConnected()`: 检查连接状态
-
-### 字符串操作
-
-- `set(key, value, seconds)`: 设置缓存
-- `get(key)`: 获取缓存
-- `has(key)`: 判断键是否存在
-- `del(key)`: 删除缓存
-- `add(key, value, seconds)`: 仅当键不存在时设置缓存
-- `ttl(key, seconds)`: 设置或获取过期时间
-- `addInt(key, num)`: 增加整数值
-- `addFloat(key, num)`: 增加浮点数值
-- `addStr(key, str)`: 追加字符串
-- `getrange(key, start, end)`: 获取字符串子串
-- `setrange(key, index, value)`: 设置字符串子串
-
-### 列表操作
-
-- `list_set(key, value, seconds)`: 设置列表
-- `list_push(key, value)`: 添加元素到列表
-- `list_get(key, start, end)`: 获取列表
-- `list_has(key, value)`: 判断列表中是否存在元素
-- `list_clear(key, value)`: 清空列表或重置列表
-
-### Hash操作
-
-- `hset(key, field, value)`: 设置哈希字段
-- `hmset(key, obj)`: 批量设置哈希字段
-- `hget(key, field)`: 获取哈希字段值
-- `hgetall(key)`: 获取哈希的所有字段和值
-- `hkeys(key)`: 获取哈希的所有字段名
-- `hvals(key)`: 获取哈希的所有字段值
-- `hdel(key, fields)`: 删除哈希字段
-- `hexists(key, field)`: 判断哈希字段是否存在
-- `hlen(key)`: 获取哈希字段数量
-
-### 批量操作
-
-- `mget(keys)`: 批量获取缓存
-- `mset(obj, seconds)`: 批量设置缓存
-- `pipeline()`: 创建Pipeline对象进行批量操作优化
-
-### 高级操作
-
-- `subscribe(channel, func)`: 订阅频道
-- `unsubscribe(channel)`: 取消订阅
-- `publish(channel, message)`: 发布消息
-- `clear(key)`: 清空缓存或当前数据库
-- `sort(key, options)`: 排序
-- `keys(pattern)`: 获取所有键名
-
-### 集合(Set)操作
-
-- `sadd(key, members)`: 添加成员到集合
-- `srem(key, members)`: 从集合中移除成员
-- `sismember(key, member)`: 检查成员是否在集合中
-- `smembers(key)`: 获取集合中的所有成员
-- `scard(key)`: 获取集合中的成员数量
-- `sinter(keys)`: 获取多个集合的交集
-- `sunion(keys)`: 获取多个集合的并集
-- `sdiff(keys)`: 获取多个集合的差集
-
-### 有序集合(Sorted Set)操作
-
-- `zadd(key, score, member)`: 添加成员到有序集合
-- `zrem(key, members)`: 从有序集合中移除成员
-- `zscore(key, member)`: 获取有序集合中成员的分数
-- `zrank(key, member)`: 获取有序集合中成员的排名
-- `zrange(key, start, stop, withScores)`: 获取有序集合中指定范围的成员
-- `zcard(key)`: 获取有序集合中的成员数量
-- `zincrby(key, increment, member)`: 增加有序集合中成员的分数
-
-### 数值操作
-
-- `incr(key)`: 将键的值增加1
-- `decr(key)`: 将键的值减少1
-- `incrby(key, increment)`: 将键的值增加指定的整数
-- `decrby(key, decrement)`: 将键的值减少指定的整数
-- `expire(key, seconds)`: 设置键的过期时间
-
-## 连接池管理
-
-本模块内置了高效的连接池管理，可自动处理连接的创建、回收和复用。连接池配置可在初始化时设置：
-
-```javascript
-{
-    "pool": {
-        "max_clients": 10,      // 最大连接数
-        "min_idle": 2,          // 最小空闲连接数
-        "max_idle": 5,          // 最大空闲连接数
-        "idle_timeout": 30000   // 空闲超时时间(ms)
-    }
-}
-```
-
-## 错误处理
-
-所有方法都包含了完善的错误处理机制，并提供详细的日志输出。在发生错误时，会自动记录错误信息，并在可能的情况下提供回退方案。
-
-## 最佳实践
-
-1. **使用连接池**: 对于高并发应用，连接池配置至关重要，合理设置最大连接数和空闲连接数
-2. **使用Pipeline**: 对于批量操作，使用Pipeline可显著提升性能
-3. **合理设置过期时间**: 避免Redis中数据无限增长
-4. **使用键前缀**: 通过键前缀进行业务隔离，避免键冲突
-5. **及时关闭连接**: 在应用结束时调用close()方法关闭所有连接
-6. **利用事件系统**: 使用事件系统进行日志记录、数据验证和操作拦截
-
-## 版本更新
-
-### 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
-- 优化连接管理
-- 完善错误处理
-- 提升代码稳定性
-
-### 1.0.0
-- 初始版本发布
+# mm_redis
+
+mm_redis是一个高效的Redis客户端封装库，提供了全面的Redis功能支持，包括连接池管理、数据类型操作、错误处理和批量操作优化。
+
+[![npm version](https://badge.fury.io/js/mm_redis.svg)](https://badge.fury.io/js/mm_redis)
+[![npm downloads](https://img.shields.io/npm/dm/mm_redis.svg)](https://www.npmjs.com/package/mm_redis)
+
+## 版本信息
+
+- **当前版本**: 1.9.4
+- **更新日期**: 2024-12-20
+- **作者**: 邱文武
+- **NPM**: [https://www.npmjs.com/package/mm_redis](https://www.npmjs.com/package/mm_redis)
+
+## 功能特性
+
+- 完整的连接池管理，优化并发性能
+- 支持Pipeline批量操作，提升执行效率
+- 支持所有主要Redis数据类型：String、List、Hash、Set、Sorted Set等
+- 自动重连机制，使用指数退避策略
+- 全面的错误处理和日志记录
+- 自动JSON序列化/反序列化
+- 键前缀管理，支持多业务隔离
+- 自动连接管理，无需手动维护连接状态
+- 统一的事件系统，支持操作前后的事件监听
+- 支持数值增减操作
+
+## 安装
+
+```bash
+npm install mm_redis --save
+```
+
+## 配置引入方式
+
+mm_redis支持多种配置引入方式：
+
+1. **对象配置（推荐）**：直接传入配置对象
+```javascript
+const Redis = require('mm_redis');
+const redis = new Redis('default');
+redis.setConfig({
+    // 服务器地址
+    host: "localhost",
+    // 端口号
+    port: 6379,
+    // 密码
+    password: "",
+    // 数据库
+    database: 0,
+    // 前缀
+    prefix: "app:",
+    // 连接超时时间(ms)
+    connect_timeout: 10000,
+    // 重试次数
+    retry_count: 3,
+    // 重试间隔(ms)
+    retry_delay: 1000,
+    // 连接池配置
+    pool: {
+        max_clients: 10,      // 最大连接数
+        min_idle: 2,          // 最小空闲连接数
+        max_idle: 5,          // 最大空闲连接数
+        idle_timeout: 30000   // 空闲超时时间(ms)
+    }
+});
+```
+
+2. **文件配置**：传入配置文件路径
+```javascript
+const Redis = require('mm_redis');
+const redis = new Redis('default');
+redis.setConfig('./config.json');
+```
+## 变更日志
+
+### v1.9.4 (2024-12-20)
+- 优化了配置引入方式，支持对象配置和文件路径配置两种方式
+- 改进了setConfig方法的实现，使用Object.assign替代原来的合并方式
+- 修复了连接池相关的警告信息
+- 增强了错误处理机制
+
+### v1.9.0 (2024-11-20)
+- 初始版本发布
+- 支持完整的连接池管理
+- 实现Pipeline批量操作
+- 支持所有主要Redis数据类型操作
+
+## 使用示例
+
+```javascript
+// 连接Redis
+await redis.open();
+
+// 设置缓存
+await redis.set('user:1', { name: '张三', age: 25 }, 3600);
+
+// 获取缓存
+const user = await redis.get('user:1');
+$.log.debug('[Redis] 获取用户信息:', user);
+
+// 判断键是否存在
+const exists = await redis.has('user:1');
+
+// 删除缓存
+await redis.del('user:1');
+
+// 关闭连接
+await redis.close();
+```
+
+### 列表操作
+
+```javascript
+// 设置列表
+await redis.list_set('users', ['user1', 'user2', 'user3']);
+
+// 添加元素到列表
+await redis.list_push('users', 'user4');
+
+// 获取列表
+const users = await redis.list_get('users');
+$.log.debug('[Redis] 用户列表:', users);
+
+// 获取列表的部分元素
+const partialUsers = await redis.list_get('users', 0, 2);
+
+// 清空列表
+await redis.list_clear('users');
+```
+
+### Hash操作
+
+```javascript
+// 设置哈希字段
+await redis.hset('user:profile:1', 'name', '张三');
+await redis.hset('user:profile:1', 'age', 25);
+
+// 批量设置哈希字段
+await redis.hmset('user:profile:1', {
+    'email': 'zhangsan@example.com',
+    'phone': '13800138000'
+});
+
+// 获取哈希字段
+const name = await redis.hget('user:profile:1', 'name');
+
+// 获取哈希的所有字段和值
+const profile = await redis.hgetall('user:profile:1');
+$.log.debug('[Redis] 用户资料:', profile);
+
+// 获取哈希的所有字段名
+const fields = await redis.hkeys('user:profile:1');
+
+// 获取哈希的所有字段值
+const values = await redis.hvals('user:profile:1');
+
+// 判断哈希字段是否存在
+const hasEmail = await redis.hexists('user:profile:1', 'email');
+
+// 获取哈希字段数量
+const fieldCount = await redis.hlen('user:profile:1');
+
+// 删除哈希字段
+await redis.hdel('user:profile:1', ['email', 'phone']);
+```
+
+### 批量操作
+
+```javascript
+// 批量获取
+const data = await redis.mget(['user:1', 'user:2', 'user:3']);
+$.log.debug('[Redis] 批量获取结果:', data);
+
+// 批量设置
+await redis.mset({
+    'user:4': { name: '李四', age: 30 },
+    'user:5': { name: '王五', age: 35 }
+}, 3600);
+```
+
+### 使用Pipeline优化批量操作
+
+```javascript
+// 创建Pipeline
+const pipeline = redis.pipeline();
+
+// 添加多个命令
+pipeline.set('counter:1', 100);
+pipeline.ttl('counter:1', 3600);
+pipeline.hset('stats:today', 'visits', 500);
+pipeline.hset('stats:today', 'users', 100);
+
+// 执行所有命令
+const results = await pipeline.exec();
+$.log.debug('[Redis] Pipeline执行结果:', results);
+```
+
+### 发布订阅
+
+```javascript
+// 订阅频道
+await redis.subscribe('notifications', async (message) => {
+    $.log.debug('[Redis] 收到通知:', message);
+    // 处理接收到的消息
+});
+
+// 发布消息
+const receivedCount = await redis.publish('notifications', JSON.stringify({ 
+    type: 'info', 
+    content: '系统更新成功' 
+}));
+
+$.log.debug(`[Redis] 消息已发布，${receivedCount}个客户端接收`);
+
+// 取消订阅
+await redis.unsubscribe('notifications');
+```
+
+### 事件系统
+
+mm_redis提供了完善的事件系统，可以监听各种操作的前后事件，用于日志记录、数据修改或操作拦截。
+
+```javascript
+// 监听设置操作前的事件
+redis.on('set_before', (data) => {
+    $.log.debug('[Redis] 设置缓存前:', data);
+    // 可以修改data中的值
+    // data.value = JSON.stringify(data.value);
+    // 可以通过设置data.cancel = true来取消操作
+});
+
+// 监听设置操作后的事件
+redis.on('set_after', (data) => {
+    $.log.debug('[Redis] 设置缓存后:', data);
+    // data包含key, value, ttl, success等信息
+});
+
+// 监听设置操作的错误事件
+redis.on('set_error', (data) => {
+    $.log.error('[Redis] 设置缓存错误:', data);
+    // data包含key, value, ttl, error等信息
+});
+```
+
+#### 事件属性规范
+
+所有事件都遵循统一的属性命名规范：
+
+1. **通用属性**：
+   - `key`: 操作的键名
+   - `value`: 操作的值（替代str、fields、obj等）
+   - `ttl`: 过期时间（替代seconds）
+   - `result`: 操作结果（替代length）
+   - `success`: 操作是否成功
+   - `cancel`: 是否取消操作（仅限前置事件）
+   - `error`: 错误信息（仅限错误事件）
+
+2. **特定属性**：
+   - `deleted`: 删除的键列表（用于del操作）
+   - `index`: 索引位置（用于setrange操作）
+   - `field`: 哈希字段名（用于hset操作）
+
+3. **事件命名模式**：
+   - 前置事件: `${methodName}_before`
+   - 后置事件: `${methodName}_after`
+   - 错误事件: `${methodName}_error`
+
+#### 支持的事件列表
+
+| 操作方法 | 前置事件 | 后置事件 | 错误事件 |
+|---------|---------|---------|--------|
+| set | set_before | set_after | set_error |
+| get | get_before | get_after | get_error |
+| del | del_before | del_after | del_error |
+| add | add_before | add_after | add_error |
+| addInt | addInt_before | addInt_after | addInt_error |
+| addFloat | addFloat_before | addFloat_after | addFloat_error |
+| addStr | addStr_before | addStr_after | addStr_error |
+| setrange | setrange_before | setrange_after | setrange_error |
+| clear | clear_before | clear_after | clear_error |
+| list_set | list_set_before | list_set_after | list_set_error |
+| list_push | list_push_before | list_push_after | list_push_error |
+| list_clear | list_clear_before | list_clear_after | list_clear_error |
+| mset | mset_before | mset_after | mset_error |
+| mget | mget_before | mget_after | mget_error |
+| hset | hset_before | hset_after | hset_error |
+| hmset | hmset_before | hmset_after | hmset_error |
+| hdel | hdel_before | hdel_after | hdel_error |
+| hget | hget_before | hget_after | hget_error |
+| hgetall | hgetall_before | hgetall_after | hgetall_error |
+| incr | incr_before | incr_after | incr_error |
+| decr | decr_before | decr_after | decr_error |
+| incrby | incrby_before | incrby_after | incrby_error |
+| decrby | decrby_before | decrby_after | decrby_error |
+| expire | expire_before | expire_after | expire_error |
+| sadd | sadd_before | sadd_after | sadd_error |
+| srem | srem_before | srem_after | srem_error |
+| zadd | zadd_before | zadd_after | zadd_error |
+
+## API文档
+
+### 连接管理
+
+- `setConfig(config)`: 设置Redis配置
+- `open()`: 连接Redis
+- `close()`: 关闭连接
+- `isConnected()`: 检查连接状态
+
+### 字符串操作
+
+- `set(key, value, seconds)`: 设置缓存
+- `get(key)`: 获取缓存
+- `has(key)`: 判断键是否存在
+- `del(key)`: 删除缓存
+- `add(key, value, seconds)`: 仅当键不存在时设置缓存
+- `ttl(key, seconds)`: 设置或获取过期时间
+- `addInt(key, num)`: 增加整数值
+- `addFloat(key, num)`: 增加浮点数值
+- `addStr(key, str)`: 追加字符串
+- `getrange(key, start, end)`: 获取字符串子串
+- `setrange(key, index, value)`: 设置字符串子串
+
+### 列表操作
+
+- `list_set(key, value, seconds)`: 设置列表
+- `list_push(key, value)`: 添加元素到列表
+- `list_get(key, start, end)`: 获取列表
+- `list_has(key, value)`: 判断列表中是否存在元素
+- `list_clear(key, value)`: 清空列表或重置列表
+
+### Hash操作
+
+- `hset(key, field, value)`: 设置哈希字段
+- `hmset(key, obj)`: 批量设置哈希字段
+- `hget(key, field)`: 获取哈希字段值
+- `hgetall(key)`: 获取哈希的所有字段和值
+- `hkeys(key)`: 获取哈希的所有字段名
+- `hvals(key)`: 获取哈希的所有字段值
+- `hdel(key, fields)`: 删除哈希字段
+- `hexists(key, field)`: 判断哈希字段是否存在
+- `hlen(key)`: 获取哈希字段数量
+
+### 批量操作
+
+- `mget(keys)`: 批量获取缓存
+- `mset(obj, seconds)`: 批量设置缓存
+- `pipeline()`: 创建Pipeline对象进行批量操作优化
+
+### 高级操作
+
+- `subscribe(channel, func)`: 订阅频道
+- `unsubscribe(channel)`: 取消订阅
+- `publish(channel, message)`: 发布消息
+- `clear(key)`: 清空缓存或当前数据库
+- `sort(key, options)`: 排序
+- `keys(pattern)`: 获取所有键名
+
+### 集合(Set)操作
+
+- `sadd(key, members)`: 添加成员到集合
+- `srem(key, members)`: 从集合中移除成员
+- `sismember(key, member)`: 检查成员是否在集合中
+- `smembers(key)`: 获取集合中的所有成员
+- `scard(key)`: 获取集合中的成员数量
+- `sinter(keys)`: 获取多个集合的交集
+- `sunion(keys)`: 获取多个集合的并集
+- `sdiff(keys)`: 获取多个集合的差集
+
+### 有序集合(Sorted Set)操作
+
+- `zadd(key, score, member)`: 添加成员到有序集合
+- `zrem(key, members)`: 从有序集合中移除成员
+- `zscore(key, member)`: 获取有序集合中成员的分数
+- `zrank(key, member)`: 获取有序集合中成员的排名
+- `zrange(key, start, stop, withScores)`: 获取有序集合中指定范围的成员
+- `zcard(key)`: 获取有序集合中的成员数量
+- `zincrby(key, increment, member)`: 增加有序集合中成员的分数
+
+### 数值操作
+
+- `incr(key)`: 将键的值增加1
+- `decr(key)`: 将键的值减少1
+- `incrby(key, increment)`: 将键的值增加指定的整数
+- `decrby(key, decrement)`: 将键的值减少指定的整数
+- `expire(key, seconds)`: 设置键的过期时间
+
+## 连接池管理
+
+本模块内置了高效的连接池管理，可自动处理连接的创建、回收和复用。连接池配置可在初始化时设置：
+
+```javascript
+{
+    "pool": {
+        "max_clients": 10,      // 最大连接数
+        "min_idle": 2,          // 最小空闲连接数
+        "max_idle": 5,          // 最大空闲连接数
+        "idle_timeout": 30000   // 空闲超时时间(ms)
+    }
+}
+```
+
+## 错误处理
+
+所有方法都包含了完善的错误处理机制，并提供详细的日志输出。在发生错误时，会自动记录错误信息，并在可能的情况下提供回退方案。
+
+## 最佳实践
+
+1. **使用连接池**: 对于高并发应用，连接池配置至关重要，合理设置最大连接数和空闲连接数
+2. **使用Pipeline**: 对于批量操作，使用Pipeline可显著提升性能
+3. **合理设置过期时间**: 避免Redis中数据无限增长
+4. **使用键前缀**: 通过键前缀进行业务隔离，避免键冲突
+5. **及时关闭连接**: 在应用结束时调用close()方法关闭所有连接
+6. **利用事件系统**: 使用事件系统进行日志记录、数据验证和操作拦截
+
+## 版本更新
+
+### 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
+- 优化连接管理
+- 完善错误处理
+- 提升代码稳定性
+
+### 1.0.0
+- 初始版本发布
 - 基础Redis功能支持

package/compatibility_table.md

@@ -0,0 +1,64 @@
+```markdown
+# 三种缓存方式方法兼容性对比表格
+
+## 核心缓存方法
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| set | ✅ | ✅ | ✅ | 完全兼容 |
+| get | ✅ | ✅ | ✅ | 完全兼容 |
+| del | ✅ | ✅ | ✅ | 完全兼容 |
+| has | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| clear | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| keys | ✅ | ✅ | ✅ | 完全兼容 |
+| ttl | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+| persist | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+| add | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| addInt | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| addStr | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| sort | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+
+## Redis兼容方法 - 哈希表操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| hset | ✅ | ✅ | ✅ | 模拟实现，通过set对象方式 |
+| hget | ✅ | ✅ | ✅ | 模拟实现，通过get对象方式 |
+| hgetall | ✅ | ✅ | ✅ | 模拟实现，返回完整对象 |
+| hdel | ✅ | ✅ | ✅ | 模拟实现，删除对象属性 |
+| hexists | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| hkeys | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| hvals | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 集合操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| sadd | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| srem | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| sismember | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| smembers | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| scard | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 有序集合操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| zadd | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zrem | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zrange | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zscore | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 其他常用命令
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| expire | ✅ | ❌ | ✅ | Redis原生支持，CacheBase通过ttl模拟 |
+| incr | ✅ | ⚠️ | ✅ | Redis原生支持，MongoDB返回undefined，CacheBase通过addInt模拟 |
+| decr | ✅ | ⚠️ | ✅ | Redis原生支持，MongoDB返回undefined，CacheBase通过addInt模拟 |
+| exists | ✅ | ✅ | ✅ | 兼容，Redis原生支持 |
+| mget | ✅ | ⚠️ | ✅ | Redis原生支持，CacheBase实现兼容 |
+| mset | ✅ | ✅ | ✅ | Redis原生支持，CacheBase实现兼容 |
+
+注：✅ 完全兼容/功能正常 | ⚠️ 部分兼容/有异常 | ❌ 不兼容/未实现
+```

package/index.js

@@ -632,7 +632,8 @@ Redis.prototype.addInt = async function (key, num) {
 		// 触发错误事件
 		this.emit('addInt_error', { key, value: num, error: err });
 		$.log.error(`[Redis] 增加整数值失败 [${key}]:`, err);
-		throw err;
+		// 与CacheBase保持一致，错误时返回默认值而不是抛出异常
+		return 0;
 	}
 };
 
@@ -648,10 +649,10 @@ Redis.prototype.addFloat = async function (key, num) {
 		const beforeEventData = { key, value: num, cancel: false };
 		this.emit('addFloat_before', beforeEventData);
 
-		// 如果事件处理器标记为取消，则抛出错误
+		// 如果事件处理器标记为取消，则返回默认值
 		if (beforeEventData.cancel) {
 			$.log.debug(`[Redis] addFloat操作被事件处理器取消 [${key}]`);
-			throw new Error('addFloat操作被取消');
+			return 0;
 		}
 
 		// 使用可能被修改的值
@@ -707,7 +708,8 @@ Redis.prototype.addFloat = async function (key, num) {
 		// 触发错误事件
 		this.emit('addFloat_error', { key, value: num, error: err });
 		$.log.error(`[Redis] 增加浮点数值失败 [${key}]:`, err);
-		throw err;
+		// 与CacheBase保持一致，错误时返回默认值而不是抛出异常
+		return 0;
 	}
 };
 
@@ -2054,7 +2056,7 @@ Redis.prototype._releaseConnection = function (connection) {
 					} else {
 						$.log.debug('[Redis] 连接对象没有可用的关闭方法');
 					}
-					$.log.debug('[Redis] 关闭多余连接:', connection.id);
+					// $.log.debug('[Redis] 关闭多余连接:', connection.id);
 				} catch (e) {
 					$.log.error('[Redis] 关闭多余连接失败:', e);
 				}
@@ -2065,6 +2067,9 @@ Redis.prototype._releaseConnection = function (connection) {
 	}
 };
 
+// 确保_recycleConnection方法是_releaseConnection的别名
+Redis.prototype._recycleConnection = Redis.prototype._releaseConnection;
+
 // 添加Hash操作相关方法
 
 /**
@@ -2891,7 +2896,7 @@ Redis.prototype._createConnection = function () {
 
 			// 连接Redis
 			connection.connect().then(() => {
-				$.log.debug('[Redis] 新连接已创建并连接:', connection.id);
+				// $.log.debug('[Redis] 新连接已创建并连接:', connection.id);
 				resolve(connection);
 			}).catch(err => {
 				$.log.error('[Redis] 创建连接失败:', err);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_redis",
-    "version": "1.9.3",
+    "version": "1.9.5",
     "description": "高效的Redis客户端封装库，提供连接池管理、数据类型操作、错误处理和批量操作优化",
     "main": "index.js",
     "scripts": {
@@ -35,7 +35,7 @@
     "homepage": "https://www.npmjs.com/package/mm_redis",
     "dependencies": {
         "mm_logs": "^1.5.2",
-        "redis": "^4.7.0"
+        "redis": "^5.8.3"
     },
     "engines": {
         "node": ">=14.0.0"