mm_cache 1.4.1 → 1.4.2

package/README.md

@@ -1,260 +1,260 @@
-# mm_cache
-
-## 项目信息
-
-- **当前版本**: 1.4.1
-- **更新日期**: 2024-12-23
-- **仓库地址**: [https://gitee.com/qiuwenwu/mm_cache](https://gitee.com/qiuwenwu/mm_cache)
-- **Node.js版本要求**: >=14.0.0，推荐16.0.0及以上
-
-## 简介
-
-mm_cache是一个统一的缓存操作框架，为多种缓存方式（Redis、MongoDB、CacheBase、Memory）提供统一的API接口，实现无缝切换和兼容。本模块作为上层抽象，整合了多种缓存实现，让开发者可以使用统一的方式操作不同的缓存系统。
-
-## 特点
-
-- **统一API接口**：为Redis、MongoDB、CacheBase、Memory提供完全一致的接口
-- **无缝切换**：支持在不同缓存实现之间快速切换，无需修改业务代码
-- **完整的方法支持**：包括核心缓存方法、原子操作、字符串操作、批量操作、过期时间操作、键操作、哈希表操作、数组/列表操作等
-- **高兼容性**：所有缓存方式支持相同的参数格式和返回值类型
-- **灵活配置**：支持多种配置方式，适应不同的应用场景
-- **一致性保证**：确保不同缓存实现的行为一致性，特别是在原子操作和过期时间处理方面
-
-## 安装
-
-```bash
-npm install mm_cache
-```
-
-## 使用方法
-
-### 基础用法
-
-```javascript
-const { Cache } = require('mm_cache');
-
-// 初始化Redis缓存
-const redisCache = new Cache({
-  cache_way: 'redis',
-  redis: {
-    host: '127.0.0.1',
-    port: 6379,
-    password: 'your_password',
-    db: 0
-  }
-});
-
-// 初始化MongoDB缓存
-const mongodbCache = new Cache({
-  cache_way: 'mongodb',
-  mongodb: {
-    url: 'mongodb://localhost:27017',
-    database: 'cache_db',
-    collection: 'cache_collection'
-  }
-});
-
-// 初始化CacheBase缓存
-const cacheBaseCache = new Cache({
-  cache_way: 'cachebase',
-  cachebase: {
-    enabled: true,
-    cache_dir: './cache'
-  }
-});
-
-// 初始化Memory缓存
-const memoryCache = new Cache({
-  cache_way: 'memory'
-});
-
-// 使用统一的API操作不同的缓存
-async function testCache(cache) {
-  // 设置缓存
-  await cache.set('key', 'value');
-  
-  // 获取缓存
-  const value = await cache.get('key');
-  console.log(value); // 'value'
-  
-  // 删除缓存
-  await cache.del('key');
-  
-  // 检查缓存是否存在
-  const exists = await cache.has('key');
-  console.log(exists); // false
-}
-
-// 使用Redis缓存
-await testCache(redisCache);
-
-// 使用MongoDB缓存（无需修改代码）
-await testCache(mongodbCache);
-
-// 使用CacheBase缓存（无需修改代码）
-await testCache(cacheBaseCache);
-
-// 使用Memory缓存（无需修改代码）
-await testCache(memoryCache);
-```
-
-### 高级用法
-
-#### 设置过期时间
-
-```javascript
-// 设置缓存并设置过期时间为60秒
-await cache.set('key', 'value', 60);
-
-// 为已存在的键设置过期时间
-await cache.expire('key', 60);
-
-// 移除过期时间
-await cache.persist('key');
-
-// 获取剩余过期时间
-const ttl = await cache.ttl('key');
-console.log(ttl); // 剩余过期时间（秒），-1表示无过期时间，-2表示键不存在
-```
-
-#### 原子操作
-
-```javascript
-// 原子递增
-const newValue = await cache.incr('counter');
-console.log(newValue); // 1, 2, 3...
-
-// 增加指定整数值
-const result = await cache.incrby('counter', 10);
-
-// 增加指定浮点数值
-const floatResult = await cache.incrbyfloat('counter', 0.5);
-
-// 减少指定整数值
-const decrResult = await cache.decrby('counter', 5);
-```
-
-#### 哈希表操作
-
-```javascript
-// 设置哈希表字段
-await cache.hset('user:1', 'name', '张三');
-await cache.hset('user:1', 'age', 25);
-
-// 获取哈希表字段
-const name = await cache.hget('user:1', 'name');
-console.log(name); // '张三'
-
-// 获取所有哈希表字段
-const user = await cache.hgetall('user:1');
-console.log(user); // { name: '张三', age: '25' }
-
-// 批量设置哈希表字段
-await cache.hmset('user:2', {
-  name: '李四',
-  age: 30,
-  email: 'lisi@example.com'
-});
-
-// 批量获取哈希表字段
-const values = await cache.hmget('user:2', ['name', 'age']);
-console.log(values); // ['李四', '30']
-
-// 删除哈希表字段
-await cache.hdel('user:1', 'age');
-
-// 获取哈希表字段数量
-const count = await cache.hlen('user:1');
-console.log(count); // 1
-```
-
-#### 数组/列表操作
-
-```javascript
-// 设置列表
-await cache.setForList('users', ['张三', '李四', '王五']);
-
-// 向列表添加元素
-await cache.addForList('users', '赵六');
-
-// 检查元素是否在列表中
-const exists = await cache.hasForList('users', '李四');
-console.log(exists); // true
-
-// 获取列表元素（支持分页）
-const users = await cache.getForList('users', 0, 2);
-console.log(users); // ['张三', '李四', '王五']
-
-// 清空列表
-await cache.clearForList('users');
-```
-
-## 方法兼容性
-
-mm_cache确保所有支持的缓存方式（Redis、MongoDB、CacheBase、Memory）都实现了相同的API接口，具体兼容性情况请参考项目中的`compatibility_table.md`文件。
-
-## 配置说明
-
-### 全局配置选项
-
-```javascript
-const cache = new Cache({
-  // 缓存方式: redis, mongodb, cachebase, memory
-  cache_way: 'redis',
-  
-  // Redis配置
-  redis: {
-    host: '127.0.0.1',
-    port: 6379,
-    password: 'your_password',
-    db: 0
-  },
-  
-  // MongoDB配置
-  mongodb: {
-    url: 'mongodb://localhost:27017',
-    database: 'cache_db',
-    collection: 'cache_collection'
-  },
-  
-  // CacheBase配置
-  cachebase: {
-    enabled: true,
-    cache_dir: './cache',
-    file_ext: '.cache.json',
-    memory_limit: 5000,
-    save_interval: 5000,
-    file_mode: 384
-  }
-});
-```
-
-## 贡献指南
-
-1. **Fork项目**：在Gitee上Fork本项目到您的账户
-2. **创建分支**：在您的仓库中创建功能分支
-3. **提交修改**：提交您的代码修改和详细的提交信息
-4. **运行测试**：确保所有测试通过
-5. **发起PR**：向原项目提交Pull Request，描述您的修改内容和目的
-
-## 问题反馈
-
-如有任何问题或建议，请通过以下方式联系我们：
-
-- **Gitee Issues**: [https://gitee.com/qiuwenwu/mm_cache/issues](https://gitee.com/qiuwenwu/mm_cache/issues)
-- **NPM**: [https://www.npmjs.com/package/mm_cache](https://www.npmjs.com/package/mm_cache)
-
-## 鸣谢
-
-感谢以下项目和工具对本模块的支持：
-
-- [Node.js](https://nodejs.org/)
-- [Redis](https://redis.io/)
-- [MongoDB](https://www.mongodb.com/)
-- [mm_cachebase](https://www.npmjs.com/package/mm_cachebase)
-- [mm_mongodb](https://www.npmjs.com/package/mm_mongodb)
-- [mm_redis](https://www.npmjs.com/package/mm_redis)
-
-## 许可证
-
+# mm_cache
+
+## 项目信息
+
+- **当前版本**: 1.4.2
+- **更新日期**: 2025-11-17
+- **仓库地址**: [https://gitee.com/qiuwenwu/mm_cache](https://gitee.com/qiuwenwu/mm_cache)
+- **Node.js版本要求**: >=14.0.0，推荐16.0.0及以上
+
+## 简介
+
+mm_cache是一个统一的缓存操作框架，为多种缓存方式（Redis、MongoDB、CacheBase、Memory）提供统一的API接口，实现无缝切换和兼容。本模块作为上层抽象，整合了多种缓存实现，让开发者可以使用统一的方式操作不同的缓存系统。
+
+## 特点
+
+- **统一API接口**：为Redis、MongoDB、CacheBase、Memory提供完全一致的接口
+- **无缝切换**：支持在不同缓存实现之间快速切换，无需修改业务代码
+- **完整的方法支持**：包括核心缓存方法、原子操作、字符串操作、批量操作、过期时间操作、键操作、哈希表操作、数组/列表操作等
+- **高兼容性**：所有缓存方式支持相同的参数格式和返回值类型
+- **灵活配置**：支持多种配置方式，适应不同的应用场景
+- **一致性保证**：确保不同缓存实现的行为一致性，特别是在原子操作和过期时间处理方面
+
+## 安装
+
+```bash
+npm install mm_cache
+```
+
+## 使用方法
+
+### 基础用法
+
+```javascript
+const { Cache } = require('mm_cache');
+
+// 初始化Redis缓存
+const redisCache = new Cache({
+  way: 'redis',
+  redis: {
+    host: '127.0.0.1',
+    port: 6379,
+    password: 'your_password',
+    db: 0
+  }
+});
+
+// 初始化MongoDB缓存
+const mongodbCache = new Cache({
+  way: 'mongodb',
+  mongodb: {
+    url: 'mongodb://localhost:27017',
+    database: 'cache_db',
+    collection: 'cache_collection'
+  }
+});
+
+// 初始化CacheBase缓存
+const cacheBaseCache = new Cache({
+  way: 'cachebase',
+  cachebase: {
+    enabled: true,
+    cache_dir: './cache'
+  }
+});
+
+// 初始化Memory缓存
+const memoryCache = new Cache({
+  way: 'memory'
+});
+
+// 使用统一的API操作不同的缓存
+async function testCache(cache) {
+  // 设置缓存
+  await cache.set('key', 'value');
+  
+  // 获取缓存
+  const value = await cache.get('key');
+  $.log.debug(value); // 'value'
+  
+  // 删除缓存
+  await cache.del('key');
+  
+  // 检查缓存是否存在
+  const exists = await cache.has('key');
+  $.log.debug(exists); // false
+}
+
+// 使用Redis缓存
+await testCache(redisCache);
+
+// 使用MongoDB缓存（无需修改代码）
+await testCache(mongodbCache);
+
+// 使用CacheBase缓存（无需修改代码）
+await testCache(cacheBaseCache);
+
+// 使用Memory缓存（无需修改代码）
+await testCache(memoryCache);
+```
+
+### 高级用法
+
+#### 设置过期时间
+
+```javascript
+// 设置缓存并设置过期时间为60秒
+await cache.set('key', 'value', 60);
+
+// 为已存在的键设置过期时间
+await cache.expire('key', 60);
+
+// 移除过期时间
+await cache.persist('key');
+
+// 获取剩余过期时间
+const ttl = await cache.ttl('key');
+$.log.debug(ttl); // 剩余过期时间（秒），-1表示无过期时间，-2表示键不存在
+```
+
+#### 原子操作
+
+```javascript
+// 原子递增
+const newValue = await cache.incr('counter');
+$.log.debug(newValue); // 1, 2, 3...
+
+// 增加指定整数值
+const result = await cache.incrby('counter', 10);
+
+// 增加指定浮点数值
+const floatResult = await cache.incrbyfloat('counter', 0.5);
+
+// 减少指定整数值
+const decrResult = await cache.decrby('counter', 5);
+```
+
+#### 哈希表操作
+
+```javascript
+// 设置哈希表字段
+await cache.hset('user:1', 'name', '张三');
+await cache.hset('user:1', 'age', 25);
+
+// 获取哈希表字段
+const name = await cache.hget('user:1', 'name');
+$.log.debug(name); // '张三'
+
+// 获取所有哈希表字段
+const user = await cache.hgetall('user:1');
+$.log.debug(user); // { name: '张三', age: '25' }
+
+// 批量设置哈希表字段
+await cache.hmset('user:2', {
+  name: '李四',
+  age: 30,
+  email: 'lisi@example.com'
+});
+
+// 批量获取哈希表字段
+const values = await cache.hmget('user:2', ['name', 'age']);
+$.log.debug(values); // ['李四', '30']
+
+// 删除哈希表字段
+await cache.hdel('user:1', 'age');
+
+// 获取哈希表字段数量
+const count = await cache.hlen('user:1');
+$.log.debug(count); // 1
+```
+
+#### 数组/列表操作
+
+```javascript
+// 设置列表
+await cache.setForList('users', ['张三', '李四', '王五']);
+
+// 向列表添加元素
+await cache.addForList('users', '赵六');
+
+// 检查元素是否在列表中
+const exists = await cache.hasForList('users', '李四');
+$.log.debug(exists); // true
+
+// 获取列表元素（支持分页）
+const users = await cache.getForList('users', 0, 2);
+$.log.debug(users); // ['张三', '李四', '王五']
+
+// 清空列表
+await cache.clearForList('users');
+```
+
+## 方法兼容性
+
+mm_cache确保所有支持的缓存方式（Redis、MongoDB、CacheBase、Memory）都实现了相同的API接口，具体兼容性情况请参考项目中的`compatibility_table.md`文件。
+
+## 配置说明
+
+### 全局配置选项
+
+```javascript
+const cache = new Cache({
+  // 缓存方式: redis, mongodb, cachebase, memory
+  way: 'redis',
+  
+  // Redis配置
+  redis: {
+    host: '127.0.0.1',
+    port: 6379,
+    password: 'your_password',
+    db: 0
+  },
+  
+  // MongoDB配置
+  mongodb: {
+    url: 'mongodb://localhost:27017',
+    database: 'cache_db',
+    collection: 'cache_collection'
+  },
+  
+  // CacheBase配置
+  cachebase: {
+    enabled: true,
+    cache_dir: './cache',
+    file_ext: '.cache.json',
+    memory_limit: 5000,
+    save_interval: 5000,
+    file_mode: 384
+  }
+});
+```
+
+## 贡献指南
+
+1. **Fork项目**：在Gitee上Fork本项目到您的账户
+2. **创建分支**：在您的仓库中创建功能分支
+3. **提交修改**：提交您的代码修改和详细的提交信息
+4. **运行测试**：确保所有测试通过
+5. **发起PR**：向原项目提交Pull Request，描述您的修改内容和目的
+
+## 问题反馈
+
+如有任何问题或建议，请通过以下方式联系我们：
+
+- **Gitee Issues**: [https://gitee.com/qiuwenwu/mm_cache/issues](https://gitee.com/qiuwenwu/mm_cache/issues)
+- **NPM**: [https://www.npmjs.com/package/mm_cache](https://www.npmjs.com/package/mm_cache)
+
+## 鸣谢
+
+感谢以下项目和工具对本模块的支持：
+
+- [Node.js](https://nodejs.org/)
+- [Redis](https://redis.io/)
+- [MongoDB](https://www.mongodb.com/)
+- [mm_cachebase](https://www.npmjs.com/package/mm_cachebase)
+- [mm_mongodb](https://www.npmjs.com/package/mm_mongodb)
+- [mm_redis](https://www.npmjs.com/package/mm_redis)
+
+## 许可证
+
 本项目使用ISC许可证 - 详情请查看 [LICENSE](LICENSE) 文件

package/compatibility_table.md

@@ -42,8 +42,8 @@
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| expire | ✅ | ✅ | ⚠️ | ⚠️ | 所有方式功能实现效果相同，参数类型和返回值一致 |
-| persist | ✅ | ✅ | ⚠️ | ⚠️ | 所有方式均正常工作 |
+| expire | ✅ | ✅ | ✅ | ✅ | 所有方式功能实现效果相同，参数类型和返回值一致 |
+| persist | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
 
 ## 键操作方法
 

package/index.js

@@ -258,7 +258,7 @@ Cache.prototype._safeCall = async function(method, args = []) {
 		return await this.db[method](...args);
 	}
 
-	// 降级处理：为常用方法提供内置实现
+	// 降级处理：仅为确实不存在的方法提供内置实现
 	switch (method) {
 		case 'strlen': {
 			const key = args[0];
@@ -306,39 +306,6 @@ Cache.prototype._safeCall = async function(method, args = []) {
 			}
 			return 'string';
 		}
-		case 'incrby': {
-			const [key, value] = args;
-			// 降级为addInt方法
-			return await this.db.addInt(key, value);
-		}
-		case 'decrby': {
-			const [key, value] = args;
-			// 降级为addInt方法，使用负值
-			return await this.db.addInt(key, -value);
-		}
-		case 'incrbyfloat': {
-			const [key, value] = args;
-			// 降级为addFloat方法
-			return await this.db.addFloat(key, value);
-		}
-		case 'mget': {
-			// 直接使用参数数组，不做额外处理
-			try {
-				// 并行获取多个键的值
-				const promises = args.map(async (key) => {
-					try {
-						return await this.db.get(key);
-					} catch (error) {
-						$.log.error(`[Cache] [_safeCall] mget获取键[${key}]失败:`, error);
-						return null;
-					}
-				});
-				return await Promise.all(promises);
-			} catch (error) {
-				$.log.error(`[Cache] [_safeCall] mget操作失败:`, error);
-				return [];
-			}
-		}
 		default:
 			// 如果方法不存在且没有降级实现，返回null
 			$.log.warn(`[Cache] [_safeCall] 不支持的方法: ${method}`);
@@ -427,7 +394,12 @@ Cache.prototype.expire = async function(key, seconds) {
 Cache.prototype.ttl = async function(key, seconds) {
 	// 添加作用域前缀
 	const scopeKey = `${this.scope}:${key}`;
-	return await this._safeCall('ttl', [scopeKey, seconds]);
+	// 仅在seconds参数存在时才传递给底层方法
+	if (seconds !== undefined) {
+		return await this._safeCall('ttl', [scopeKey, seconds]);
+	} else {
+		return await this._safeCall('ttl', [scopeKey]);
+	}
 };
 
 /**

package/package.json

@@ -1,14 +1,14 @@
 {
     "name": "mm_cache",
-    "version": "1.4.1",
-    "description": "这是超级美眉cache帮助函数模块，一个简单的内存+硬盘缓存",
+    "version": "1.4.2",
+    "description": "一个统一的缓存操作框架，为多种缓存方式（Redis、MongoDB、CacheBase、Memory）提供统一的API接口，实现无缝切换和兼容",
     "main": "index.js",
     "scripts": {
         "test": "node test.js"
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/qiuwenwu/mm_cache.git"
+        "url": "git+https://gitee.com/qiuwenwu/mm_cache.git"
     },
     "keywords": [
         "cache",
@@ -26,12 +26,12 @@
     "author": "邱文武",
     "license": "ISC",
     "bugs": {
-        "url": "https://github.com/qiuwenwu/mm_cache/issues"
+        "url": "https://gitee.com/qiuwenwu/mm_cache/issues"
     },
-    "homepage": "https://github.com/qiuwenwu/mm_cache#readme",
+    "homepage": "https://gitee.com/qiuwenwu/mm_cache#readme",
     "dependencies": {
-        "mm_cachebase": "^1.8.7",
-        "mm_mongodb": "^1.4.9",
-        "mm_redis": "^1.9.9"
+        "mm_cachebase": "^1.8.9",
+        "mm_mongodb": "^1.5.1",
+        "mm_redis": "^2.0.3"
     }
-}
+}

package/test.js

@@ -87,8 +87,8 @@ async function recordTestResult(cache, methodName, testFunction) {
         // 对关键方法失败时输出详细信息
         const criticalMethods = ['hdel', 'hmset', 'hmget', 'hlen', 'addForList', 'expire'];
         if (criticalMethods.includes(methodName)) {
-            console.error(`[Cache] ${cacheWay}.${methodName} 测试失败: ${error.message}`);
-            console.error(error.stack);
+            $.log.error(`[Cache] ${cacheWay}.${methodName} 测试失败: ${error.message}`);
+            $.log.error(error.stack);
         }
         
         // 检查是否是"不支持的方法"错误
@@ -448,19 +448,19 @@ function getUnsupportedReason(method) {
 
 // 测试单个缓存方式的所有方法
 async function testCacheWay(cacheWay) {
-    console.log(`\n[Cache] ==============================`);
-    console.log(`[Cache] 开始测试缓存方式: ${cacheWay}`);
-    console.log(`[Cache] ==============================`);
+    $.log.debug(`\n[Cache] ==============================`);
+    $.log.debug(`[Cache] 开始测试缓存方式: ${cacheWay}`);
+    $.log.debug(`[Cache] ==============================`);
     
     // 直接使用指定的缓存方式创建Cache实例
     const cache = new Cache(`test_${cacheWay}`, { way: cacheWay });
     const connected = await cache.connect();
     
     if (connected) {
-        console.log(`[Cache] 成功连接到缓存方式: ${cacheWay}`);
-        console.log(`[Cache] 当前实际缓存方式: ${cache.getCacheWay()}`);
+        $.log.debug(`[Cache] 成功连接到缓存方式: ${cacheWay}`);
+        $.log.debug(`[Cache] 当前实际缓存方式: ${cache.getCacheWay()}`);
     } else {
-        console.log(`[Cache] 无法连接到缓存方式: ${cacheWay}`);
+        $.log.debug(`[Cache] 无法连接到缓存方式: ${cacheWay}`);
         return false;
     }