mm_cachebase 1.8.4 → 1.8.6

package/compatibility_table.md

@@ -4,199 +4,98 @@
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| set | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
+| set | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致 |
 | get | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| del | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| has | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| clear | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| keys | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| ttl | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
+| del | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致 |
+| has | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| clear | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致 |
+| keys | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| ttl | ✅ | ⚠️ | ✅ | ✅ | Redis、CacheBase和Memory与Redis行为一致，MongoDB行为不一致 |
 | add | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| addInt | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| addStr | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| sort | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| list_set | ✅ | ⚠️ | ⚠️ | ⚠️ | 所有方式均通过通用实现支持，但底层可能需要各自实现 |
-| list_add | ✅ | ⚠️ | ⚠️ | ⚠️ | 所有方式均通过通用实现支持，但底层可能需要各自实现 |
-| list_has | ✅ | ⚠️ | ⚠️ | ⚠️ | 所有方式均通过通用实现支持，但底层可能需要各自实现 |
-| list_get | ✅ | ⚠️ | ⚠️ | ⚠️ | 所有方式均通过通用实现支持，但底层可能需要各自实现 |
-| list_clear | ✅ | ⚠️ | ⚠️ | ⚠️ | 所有方式均通过通用实现支持，但底层可能需要各自实现 |
+| addInt | ✅ | ❌ | ✅ | ✅ | Redis正常工作，MongoDB追加失败，Memory和CacheBase支持 |
+| addStr | ✅ | ❌ | ✅ | ✅ | Redis正常工作，MongoDB追加失败，Memory和CacheBase支持 |
+| sort | ✅ | ✅ | ❌ | ❌ | Redis和MongoDB支持，其他方式不支持 |
+| exists | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致，支持多键检查并返回数量 |
 
 ## Redis兼容方法 - 哈希表操作
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| hset | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
+| hset | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致，新字段返回1，更新返回0 |
 | hget | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| hgetall | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| hdel | ⚠️ | ⚠️ | ⚠️ | ⚠️ | 所有方式均返回0，但实际能删除字段 |
-| hmset | ✅ | ✅ | ✅ | ✅ | 哈希表批量设置，所有方式均正常工作 |
-| hmget | ✅ | ✅ | ✅ | ✅ | 哈希表批量获取，所有方式均正常工作 |
-| hlen | ✅ | ✅ | ✅ | ✅ | 获取哈希表长度，所有方式均正常工作 |
+| hgetall | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| hdel | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| hmset | ✅ | ✅ | ❌ | ❌ | Redis和MongoDB支持，其他方式不支持 |
+| hmget | ❌ | ✅ | ❌ | ❌ | 仅MongoDB支持 |
+| hlen | ✅ | ✅ | ❌ | ❌ | Redis和MongoDB支持，其他方式不支持 |
 
 ## Redis兼容方法 - 其他常用命令
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| expire | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| incr | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作，返回正确数值 |
-| decr | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作，返回正确数值 |
-| exists | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| mget | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作，返回正确的结果数组 |
-| mset | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| pexpire | ✅ | ✅ | ✅ | ✅ | 毫秒级过期时间设置，所有方式均正常工作 |
-| persist | ✅ | ✅ | ✅ | ✅ | 移除过期时间，所有方式均正常工作 |
-| strlen | ✅ | ✅ | ✅ | ✅ | 字符串长度获取，所有方式均正常工作 |
-| type | ✅ | ✅ | ✅ | ✅ | 数据类型检测，所有方式均正常工作 |
-| rename | ✅ | ✅ | ✅ | ✅ | 键重命名，所有方式均正常工作 |
+| expire | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| incr | ✅ | ✅ | ✅ | ✅ | 所有方式都支持 |
+| decr | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory支持，MongoDB不支持 |
+| mget | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致，返回数组与输入键顺序一致 |
+| mset | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致，返回'OK' |
+| pexpire | ❌ | ❌ | ❌ | ❌ | 所有方式都不支持 |
+| persist | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory支持，MongoDB不支持 |
+| strlen | ✅ | ❌ | ✅ | ❌ | Redis和CacheBase支持，其他方式不支持 |
+| type | ❌ | ❌ | ❌ | ❌ | 所有方式都不支持 |
+| rename | ❌ | ❌ | ❌ | ❌ | 所有方式都不支持 |
 
 ## Redis兼容方法 - 集合操作
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| sadd | ✅ | ✅ | ✅ | ✅ | 集合添加元素，所有方式均正常工作 |
-| srem | ✅ | ✅ | ✅ | ✅ | 集合移除元素，所有方式均正常工作 |
-| sismember | ✅ | ✅ | ✅ | ✅ | 检查元素是否在集合中，所有方式均正常工作 |
-| smembers | ✅ | ✅ | ✅ | ✅ | 获取集合所有元素，所有方式均正常工作 |
+| sadd | ✅ | ❌ | ❌ | ❌ | 仅Redis支持 |
+| srem | ✅ | ❌ | ❌ | ❌ | 仅Redis支持 |
+| sismember | ✅ | ✅ | ❌ | ❌ | Redis和MongoDB支持，其他方式不支持 |
+| smembers | ✅ | ✅ | ❌ | ❌ | Redis和MongoDB支持，其他方式不支持 |
 
 ## 数组/列表操作方法
 
 | 方法名 | Redis | MongoDB | CacheBase | Memory | 状态说明 |
 |-------|-------|---------|-----------|--------|----------|
-| list_set | ✅ | ✅ | ✅ | ✅ | 已实现并测试通过 |
-| list_add | ✅ | ✅ | ✅ | ✅ | 已实现并测试通过 |
-| list_has | ✅ | ✅ | ✅ | ✅ | 已实现并测试通过 |
-| list_get | ✅ | ✅ | ✅ | ✅ | 已实现并测试通过 |
-| list_clear | ✅ | ✅ | ✅ | ✅ | 已实现并测试通过 |
+| list_set | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory均与Redis行为完全一致 |
+| list_add | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory均与Redis行为完全一致 |
+| list_has | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory均与Redis行为完全一致 |
+| list_get | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory均与Redis行为完全一致，支持范围获取 |
+| list_clear | ✅ | ❌ | ✅ | ✅ | Redis、CacheBase和Memory均支持，保持过期时间 |
 
 ## 兼容性报告总结
 
-基于全面测试，以下是四种缓存方式的兼容性报告：
+基于实际功能测试，以下是四种缓存方式的兼容性报告：
 
 | 方法类别 | CacheBase | Redis | MongoDB | Memory | 状态说明 |
 |---------|-----------|-------|---------|--------|----------|
-| 基础键值操作 | ✅ | ✅ | ✅ | ✅ | 所有方式均正常工作 |
-| 数组操作 | ⚠️ | ✅ | ⚠️ | ⚠️ | 所有方式通过通用实现支持，但底层可能需要各自实现 |
-| 过期时间操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 原子递增操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 批量操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 哈希表基本操作 | ⚠️ | ⚠️ | ⚠️ | ⚠️ | hdel方法返回0，但实际能删除字段，其他方法正常 |
-| 哈希表批量操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 集合操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 字符串操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 类型检测 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 键重命名 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
-| 清理操作 | ✅ | ✅ | ✅ | ✅ | 全兼容 |
+| 基础键值操作 | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致 |
+| 数组操作 | ✅ | ✅ | ❌ | ✅ | Redis、CacheBase和Memory完全支持，MongoDB不支持 |
+| 过期时间操作 | ✅ | ✅ | ✅ | ✅ | 基本过期时间操作支持，但MongoDB不支持persist |
+| 原子递增操作 | ✅ | ✅ | ⚠️ | ✅ | incr和decr都支持，MongoDB不支持decr |
+| 批量操作 | ✅ | ✅ | ✅ | ✅ | 所有方式均与Redis行为完全一致 |
+| 哈希表基本操作 | ✅ | ✅ | ✅ | ✅ | 基本操作均支持 |
+| 哈希表批量操作 | ❌ | ✅ | ✅ | ❌ | Redis和MongoDB支持，其他方式不支持 |
+| 集合操作 | ❌ | ✅ | ⚠️ | ❌ | Redis完整支持，MongoDB支持部分方法，其他方式不支持 |
+| 字符串操作 | ✅ | ✅ | ❌ | ⚠️ | Redis和CacheBase支持，Memory部分支持，MongoDB不支持 |
+| 类型检测 | ❌ | ❌ | ❌ | ❌ | 所有方式都不支持 |
+| 键重命名 | ❌ | ❌ | ❌ | ❌ | 所有方式都不支持 |
+| 清理操作 | ✅ | ✅ | ✅ | ✅ | clear操作正常工作 |
 
 ### 测试统计
 
-- **总测试用例**：43个
-- **通过数**：43个测试用例
-- **整体成功率**：100%
-- **注意事项**：hdel方法在所有缓存方式下返回0，但实际能删除字段
-
-### 所有缓存方式都支持的功能：
-- **核心键值操作**：set, get, exists, del, has, keys, sort（add除外）
-- **哈希表操作**：hset, hget, hgetall, hdel, hmset, hmget, hlen
-- **过期时间操作**：expire, ttl, persist, pexpire
-- **原子递增操作**：incr, decr
-- **批量操作**：mset, mget
-- **集合操作**：sadd, srem, sismember, smembers
-- **字符串操作**：strlen
-- **类型检测**：type
-- **键重命名**：rename
-- **清理操作**：clear
-- **数组操作**：list_set, list_add, list_has, list_get, list_clear (通过通用实现)
-
-### CacheBase 缓存方式：
-- **测试状态**：✅ 所有12个方法类别测试通过
-- **兼容性**：完全兼容Redis接口
-- **返回值**：所有操作都返回符合预期的结果
-- **优点**：无需外部依赖，性能优秀，返回值一致性高，支持持久化
-
-### MongoDB 缓存方式：
-- **测试状态**：✅ 所有12个方法类别测试通过
-- **兼容性**：完全兼容Redis接口
-- **返回值**：所有操作都返回正确的结果，包括incr/decr返回数值，mget返回正确的结果数组
-- **优点**：支持持久化存储，重启后数据不会丢失
-
-### Redis 缓存方式：
-- **测试状态**：✅ 所有12个方法类别测试通过
-- **通过率**：100%
-- **优点**：支持持久化存储，重启后数据不会丢失，支持分布式缓存
-- **注意事项**：已修复认证配置问题，现在可以正常使用
-
-### Memory 缓存方式：
-- **测试状态**：✅ 所有12个方法类别测试通过
-- **兼容性**：完全兼容Redis接口
-- **优点**：最高性能，纯内存操作，无I/O开销
-- **缺点**：不支持持久化，程序重启后数据会丢失
-
-### 已确认移除的方法：
-- hexists：测试中报错 "TypeError: cache.hexists is not a function"
-- hkeys、hvals：已移除
-
-## 最佳使用建议
-
-1. **Memory 方式**（推荐用于内存临时缓存）：
-   - 所有功能完全兼容，返回值符合预期
-   - 性能最优，纯内存操作无I/O开销
-   - 适合短期缓存、临时数据缓存场景
-   - 不需要额外的外部服务依赖
-   - 程序重启后数据会丢失
-
-2. **CacheBase 方式**（推荐用于单机持久化缓存）：
-   - 所有功能完全兼容，返回值符合预期
-   - 性能稳定，在多次依赖更新中保持一致表现
-   - 适合需要持久化但不需要分布式的场景
-   - 不需要额外的外部服务依赖
-   - 程序重启后数据不会丢失
-
-3. **Redis 方式**（推荐用于分布式持久化缓存）：
-   - 已完全修复所有兼容性问题
-   - 支持分布式缓存，数据可在多实例间共享
-   - 适合需要高性能、分布式缓存或Redis特有功能的场景
-   - 需要外部Redis服务
-   - 程序重启后数据不会丢失
-
-4. **MongoDB 方式**（推荐用于已有MongoDB环境的场景）：
-   - 所有方法均完全兼容Redis接口
-   - 所有操作都返回正确的结果，包括incr/decr和mget
-   - 适合需要持久化缓存且已有MongoDB环境的场景
-   - 提供了数据持久化保障
-   - 需要外部MongoDB服务
-   - 程序重启后数据不会丢失
-
-## 实际使用建议
-
-1. **开发环境**：推荐使用Memory或CacheBase，无需额外配置，使用简单
-
-2. **生产环境**：
-   - 如果需要极致性能且数据不敏感：使用Memory
-   - 如果需要单机持久化：使用CacheBase
-   - 如果需要高性能、分布式缓存：使用Redis
-   - 如果需要缓存持久化且已有MongoDB环境：使用MongoDB
-
-3. **跨环境部署**：
-   - 可以根据环境配置自动切换缓存方式
-   - 所有缓存方式的返回值特性一致，可以放心切换
-
-4. **性能考虑**：
-   - Memory：纯内存操作，最快但不持久化
-   - CacheBase：文件系统操作，性能优秀且支持持久化
-   - Redis：网络操作，但性能优秀，支持持久化和分布式
-   - MongoDB：网络+磁盘操作，性能相对较低但支持持久化
-
-## 兼容性维护建议
-
-1. **文档维护**：
-   - 更新README.md，明确标注支持的方法和各缓存方式的特点
-
-2. **测试维护**：
-   - 保留test.js作为标准全面兼容性测试
-   - 在发布新版本前运行全面测试
-
-3. **错误处理**：
-   - 对已移除的方法添加更友好的错误提示
-   - 考虑在代码中添加方法兼容性检测
-
-注：✅ 完全兼容/功能正常 | ⚠️ 功能正常但有注意事项 | ❌ 不兼容/未实现/已移除
+- **总测试用例**：38个方法
+- **通过数**：不同缓存方式通过数量不同（Redis最多，CacheBase和Memory次之）
+- **整体支持情况**：
+  - Redis：支持31个方法，不支持7个，行为不一致0个
+  - MongoDB：支持23个方法，不支持15个，行为不一致0个
+  - CacheBase：支持31个方法，不支持7个，行为不一致0个
+  - Memory：支持30个方法，不支持7个，行为不一致0个
+- **注意事项**：
+  1. CacheBase和Memory的行为高度一致，只有strlen方法在Memory中不支持
+  2. Redis、CacheBase和Memory在已实现的方法上行为完全一致
+  3. MongoDB完全不支持列表操作方法（list_*）
+  4. addInt和addStr方法已在基类中添加，Redis支持，MongoDB追加失败，CacheBase和Memory支持
+  5. 基础键值操作、批量操作、数组操作在Redis、CacheBase和Memory中表现最佳
+  6. 集合操作只有Redis完整支持
+  7. 所有已实现方法在Redis、CacheBase和Memory中具有完全一致的行为和返回值