mm_cachebase 1.7.0 → 1.8.0

package/README.md

@@ -273,15 +273,17 @@ await cache.has(key)
 
 #### 增加浮点数（兼容方法）
 ```javascript
-await cache.addFloat(key, num)
+await cache.addFloat(key, num, maxAge)
 ```
 - `num`: 要增加的浮点数
+- `maxAge`: 过期时间（秒），默认0表示永不过期
 - 返回: 计算后的结果
 
 #### 追加字符串（兼容方法）
 ```javascript
-await cache.addStr(key, str)
+await cache.addStr(key, str, maxAge)
 ```
+- `maxAge`: 过期时间（秒），默认0表示永不过期
 - 返回: 追加后的完整字符串
 
 #### 清空匹配缓存（兼容方法）

package/compatibility_table.md

@@ -12,6 +12,7 @@
 | clear | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
 | keys | ✅ | ✅ | ✅ | 完全兼容 |
 | ttl | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+| persist | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
 | add | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
 | addInt | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
 | addStr | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |

package/index.js

@@ -8,7 +8,7 @@ class CacheBase extends EventEmitter {
    */
   constructor(scope = 'sys', config = {}) {
     super();
-    
+
     // 持久化相关属性
     this.scope = scope;
     // 配置选项
@@ -24,25 +24,24 @@ class CacheBase extends EventEmitter {
     // 键列表，用于存储所有的键名
     this.list = [];
     this.saveTimer = null;
-    this.persist = config.persist || false;
     this.dir = this.config.dir;
     this.setConfig(config);
     this.init();
   }
-  
+
   /**
    * 初始化方法
    * @private
    */
   init() {
     // 如果启用了持久化，尝试加载数据
-    if (this.persist) {
+    if (this.config.persist) {
       this._loadData().catch(error => {
         $.log.error('[cachebase] 数据加载失败:', error);
       });
     }
   }
-  
+
   /**
    * 启动定时保存功能
    * @returns {Promise<boolean>} 是否成功连接
@@ -50,17 +49,17 @@ class CacheBase extends EventEmitter {
   async connect() {
     try {
       this.emit('connect_before');
-      
+
       // 只有在启用持久化时才启动定时保存
-      if (this.persist) {
+      if (this.config.persist) {
         // 先立即保存一次
         await this._saveData();
-        
+
         // 清除已存在的定时器（如果有）
         if (this.saveTimer) {
           clearInterval(this.saveTimer);
         }
-        
+
         // 设置新的定时器
         const interval = this.config.saveInterval || 60000;
         this.saveTimer = setInterval(() => {
@@ -68,10 +67,10 @@ class CacheBase extends EventEmitter {
             $.log.error('[cachebase] 定时保存失败:', error);
           });
         }, interval);
-        
+
         $.log.info(`[cachebase] 定时保存已启动，间隔 ${interval}ms`);
       }
-      
+
       this.emit('connect_after');
       return true;
     } catch (error) {
@@ -80,7 +79,7 @@ class CacheBase extends EventEmitter {
       return false;
     }
   }
-  
+
   /**
    * 手动保存数据到文件
    * @returns {Promise<boolean>} 是否保存成功
@@ -97,24 +96,24 @@ class CacheBase extends EventEmitter {
       return false;
     }
   }
-  
+
   /**
    * 保存数据到文件
    * @private
    * @returns {Promise<void>}
    */
   async _saveData() {
-    if (!this.persist) return;
-    
+    if (!this.config.persist) return;
+
     try {
       // 确保目录存在
       this.dir.addDir();
-      
+
       // 过滤过期数据
       const now = Date.now();
       const validData = {};
       const validList = [];
-      
+
       for (const key of this.list) {
         if (this.data.hasOwnProperty(key)) {
           const item = this.data[key];
@@ -125,14 +124,14 @@ class CacheBase extends EventEmitter {
           }
         }
       }
-      
+
       // 准备保存的数据
       const saveData = {
         data: validData,
         list: validList,
         timestamp: now
       };
-      
+
       // 保存到文件
       const file = `./${this.scope}.cache.json`.fullname(this.dir);
       file.saveJson(saveData);
@@ -142,42 +141,42 @@ class CacheBase extends EventEmitter {
       throw error;
     }
   }
-  
+
   /**
    * 从文件加载数据
    * @private
    * @returns {Promise<void>}
    */
   async _loadData() {
-    if (!this.persist) return;
-    
+    if (!this.config.persist) return;
+
     try {
       // 确保目录存在
       this.dir.addDir();
-      
+
       // 只加载当前scope的缓存文件
       const file = `./${this.scope}.cache.json`.fullname(this.dir);
-      
+
       if (!file.hasFile()) {
         $.log.debug(`[cachebase] 未找到当前scope的缓存文件: ${file}`);
         return;
       }
-      
+
       $.log.debug(`[cachebase] 尝试从 ${file} 加载数据`);
-      
+
       try {
         try {
           const savedData = file.loadJson();
           $.log.debug(`[cachebase] 解析数据成功，包含data: ${savedData.data ? '是' : '否'}, list: ${savedData.list ? '是' : '否'}`);
-          
+
           if (savedData.data && savedData.list && Array.isArray(savedData.list)) {
             $.log.debug(`[cachebase] 数据格式正确，list长度: ${savedData.list.length}`);
-            
+
             // 验证数据并过滤过期项
             const now = Date.now();
             const validData = {};
             const validList = [];
-            
+
             for (const key of savedData.list) {
               if (savedData.data.hasOwnProperty(key)) {
                 const item = savedData.data[key];
@@ -191,12 +190,12 @@ class CacheBase extends EventEmitter {
                 }
               }
             }
-            
+
             // 直接使用加载的数据替换当前数据
             this.data = validData;
             this.list = validList;
             this.dict = this.data; // 确保dict指向最新的data
-            
+
             $.log.info(`[cachebase] 从 ${this.scope}.cache.json 加载数据成功，共 ${validList.length} 个键`);
             if (validList.length > 0) {
               $.log.debug(`[cachebase] 加载的键: ${validList.join(', ')}`);
@@ -586,6 +585,47 @@ class CacheBase extends EventEmitter {
     }
   }
 
+  /**
+   * 移除键的过期时间，使其永不过期
+   * @param {string} key - 键名
+   * @returns {Promise<number>} - 返回1表示成功移除过期时间，0表示键不存在
+   */
+  async persist(key) {
+    try {
+      this.emit('persist_before', { key });
+      
+      // 检查键是否存在
+      if (!this.data.hasOwnProperty(key)) {
+        this.emit('persist_after', { key, result: 0 });
+        return 0;
+      }
+      
+      const item = this.data[key];
+      
+      // 检查是否已过期
+      if (item.expire > 0 && Date.now() > item.expire) {
+        // 键已过期，删除并返回0
+        delete this.data[key];
+        const index = this.list.indexOf(key);
+        if (index !== -1) {
+          this.list.splice(index, 1);
+        }
+        this.emit('persist_after', { key, result: 0 });
+        return 0;
+      }
+      
+      // 设置为永不过期
+      item.expire = 0;
+      
+      this.emit('persist_after', { key, result: 1 });
+      return 1;
+    } catch (error) {
+      this.emit('persist_error', { key, error });
+      $.log.error('[cachebase] persist操作失败:', error);
+      throw error;
+    }
+  }
+
   /**
    * 获取键的剩余生存时间
    * @param {string} key - 键名
@@ -1040,52 +1080,202 @@ class CacheBase extends EventEmitter {
     }
   }
 
-  /**
-   * 清空数据库
-   * @returns {Promise<string>} - 返回'OK'
-   */
-  async flushdb() {
+  // 保持兼容性的方法
+  async has(key) {
+    try {
+      const exists = await this.exists(key);
+      return exists > 0;
+    } catch (error) {
+      $.log.error('[cachebase] has操作失败:', error);
+      throw error;
+    }
+  }
+
+  async clear(pattern) {
     try {
-      this.emit('flushdb_before');
+      this.emit('clear_before');
 
       // 清空数据
       this.data = {};
       this.list = [];
 
-      this.emit('flushdb_after', { result: 'OK' });
+      this.emit('clear_after', { result: 'OK' });
       return 'OK';
     } catch (error) {
-      this.emit('flushdb_error', { error });
-      $.log.error('[cachebase] flushdb操作失败:', error);
+      this.emit('clear_error', { error });
+      $.log.error('[cachebase] clear操作失败:', error);
       throw error;
     }
   }
 
-  // 保持兼容性的方法
-  async has(key) {
+  /**
+   * 添加缓存（仅当键不存在时）- 兼容方法
+   * @param {string} key - 键名
+   * @param {number} value - 要增加的值
+   * @param {number} maxAge - 过期时间（秒），0表示永不过期
+   * @returns {Promise<number>} - 计算后的结果
+   */
+  async add(key, value, maxAge = 0) {
     try {
-      const exists = await this.exists(key);
-      return exists > 0;
+      this.emit('add_before', { key, value, maxAge });
+
+      // 原生实现递增逻辑
+      let currentValue = 0;
+      if (this.data.hasOwnProperty(key)) {
+        const item = this.data[key];
+        if (item.expire === 0 || Date.now() < item.expire) {
+          currentValue = Number(item.value) || 0;
+        }
+      }
+      const result = currentValue + Number(value);
+
+      // 设置值和过期时间
+      this.data[key] = {
+        value: result,
+        expire: maxAge > 0 ? Date.now() + maxAge * 1000 : 0
+      };
+
+      // 更新列表
+      if (!this.list.includes(key)) {
+        this.list.push(key);
+      }
+
+      this.emit('add_after', { key, value, maxAge, result });
+      return result;
     } catch (error) {
-      $.log.error('[cachebase] has操作失败:', error);
+      this.emit('add_error', { key, value, maxAge, error });
+      $.log.error('[cachebase] add操作失败:', error);
       throw error;
     }
   }
 
-  async clear(pattern) {
-    return this.flushdb();
-  }
+  /**
+   * 增加浮点数（兼容方法）
+   * @param {string} key - 键名
+   * @param {number} num - 要增加的浮点数
+   * @param {number} maxAge - 过期时间（秒），0表示永不过期
+   * @returns {Promise<number>} - 计算后的结果
+   */
+  async addFloat(key, num, maxAge = 0) {
+    try {
+      this.emit('addFloat_before', { key, num, maxAge });
+
+      // 原生实现浮点数递增逻辑
+      let currentValue = 0;
+      if (this.data.hasOwnProperty(key)) {
+        const item = this.data[key];
+        if (item.expire === 0 || Date.now() < item.expire) {
+          currentValue = Number(item.value) || 0;
+        }
+      }
+      const result = currentValue + Number(num);
+
+      // 设置值和过期时间
+      this.data[key] = {
+        value: result,
+        expire: maxAge > 0 ? Date.now() + maxAge * 1000 : 0
+      };
 
-  async add(key, value) {
-    return this.incrby(key, value);
+      // 更新列表
+      if (!this.list.includes(key)) {
+        this.list.push(key);
+      }
+
+      this.emit('addFloat_after', { key, num, maxAge, result });
+      return result;
+    } catch (error) {
+      this.emit('addFloat_error', { key, num, maxAge, error });
+      $.log.error('[cachebase] addFloat操作失败:', error);
+      throw error;
+    }
   }
 
-  async addFloat(key, value) {
-    return this.incrbyfloat(key, value);
+  /**
+   * 增加整数（兼容方法）
+   * @param {string} key - 键名
+   * @param {number} value - 要增加的整数值
+   * @param {number} maxAge - 过期时间（秒），0表示永不过期
+   * @returns {Promise<number>} - 计算后的整数结果
+   */
+  async addInt(key, value, maxAge = 0) {
+    try {
+      this.emit('addInt_before', { key, value, maxAge });
+
+      // 原生实现整数递增逻辑
+      let currentValue = 0;
+      if (this.data.hasOwnProperty(key)) {
+        const item = this.data[key];
+        if (item.expire === 0 || Date.now() < item.expire) {
+          currentValue = parseInt(item.value, 10) || 0;
+        }
+      }
+      const result = currentValue + parseInt(value, 10);
+
+      // 设置值和过期时间
+      this.data[key] = {
+        value: result,
+        expire: maxAge > 0 ? Date.now() + maxAge * 1000 : 0
+      };
+
+      // 更新列表
+      if (!this.list.includes(key)) {
+        this.list.push(key);
+      }
+
+      this.emit('addInt_after', { key, value, maxAge, result });
+      return result;
+    } catch (error) {
+      this.emit('addInt_error', { key, value, maxAge, error });
+      $.log.error('[cachebase] addInt操作失败:', error);
+      throw error;
+    }
   }
+  /**
+   * 追加字符串（兼容方法）
+   * @param {string} key - 键名
+   * @param {string} value - 要追加的字符串
+   * @param {number} maxAge - 过期时间（秒），0表示永不过期
+   * @returns {Promise<number>} - 追加后的字符串长度
+   */
+  async addStr(key, value, maxAge = 0) {
+    try {
+      this.emit('addStr_before', { key, value, maxAge });
+
+      // 原生实现字符串追加逻辑
+      let currentValue = '';
+      let originalExpire = 0;
 
-  async addStr(key, value) {
-    return this.append(key, value);
+      if (this.data.hasOwnProperty(key)) {
+        const item = this.data[key];
+        if (item.expire === 0 || Date.now() < item.expire) {
+          currentValue = String(item.value) || '';
+          originalExpire = item.expire;
+        }
+      }
+
+      const newValue = currentValue + String(value);
+      const result = newValue.length;
+
+      // 设置值和过期时间（如果提供了新的过期时间，则使用新的，否则保持原来的）
+      const expireTime = maxAge > 0 ? Date.now() + maxAge * 1000 : originalExpire;
+
+      this.data[key] = {
+        value: newValue,
+        expire: expireTime
+      };
+
+      // 更新列表
+      if (!this.list.includes(key)) {
+        this.list.push(key);
+      }
+
+      this.emit('addStr_after', { key, value, maxAge, result });
+      return result;
+    } catch (error) {
+      this.emit('addStr_error', { key, value, maxAge, error });
+      $.log.error('[cachebase] addStr操作失败:', error);
+      throw error;
+    }
   }
 
   /**
@@ -1095,28 +1285,28 @@ class CacheBase extends EventEmitter {
   async dispose() {
     try {
       this.emit('dispose_before');
-      
+
       // 清除定时器
       if (this.saveTimer) {
         clearInterval(this.saveTimer);
         this.saveTimer = null;
         $.log.info('[cachebase] 定时保存已停止');
       }
-      
+
       // 如果启用了持久化，在销毁前保存一次
-      if (this.persist) {
+      if (this.config.persist) {
         await this._saveData().catch(error => {
           $.log.error('[cachebase] 销毁前保存数据失败:', error);
         });
       }
-      
+
       // 清空数据
       this.data = {};
       this.list = [];
       this.dict = this.data; // 确保dict也被清空
-      
+
       this.emit('dispose_after');
-      
+
       // 移除所有监听器
       this.removeAllListeners();
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_cachebase",
-    "version": "1.7.0",
+    "version": "1.8.0",
     "description": "一个轻量级的本地缓存类库，提供与Redis兼容的API接口，支持过期时间设置、哈希表操作、数值操作、字符串操作等功能，以及完整的事件通知系统和多文件持久化功能。",
     "main": "index.js",
     "scripts": {

package/test.js

@@ -107,7 +107,7 @@ async function testBasicMethods(runner) {
   });
   
   await runner.runTest('keys方法', async () => {
-    await cache.flushdb();
+    await cache.clear();
     await cache.set('key4', 'value4');
     await cache.set('key5', 'value5');
     const keys = await cache.keys();
@@ -139,7 +139,7 @@ async function testBasicMethods(runner) {
   });
   
   await runner.runTest('flushdb/clear方法', async () => {
-    let result = await cache.flushdb();
+    let result = await cache.clear();
     if (result !== 'OK') {
       throw new Error(`flushdb失败，预期: OK, 实际: ${result}`);
     }