缓存处理

概述

缓存操作处理器，支持多种Redis缓存操作，包括数据存储、读取、删除、键检查、分布式锁等。通过Redisson客户端实现高性能的分布式缓存功能。

功能特性

多种缓存操作：支持存储、读取、删除、键检查等7种操作

分布式锁：支持分布式锁的获取和释放

自动过期：支持设置缓存过期时间

高性能：基于Redisson的高性能Redis客户端

安全隔离：支持多租户数据隔离

支持的操作类型

SAVE_CACHE - 保存缓存

将数据存储到缓存中，支持设置过期时间。

READ_CACHE - 读取缓存

从缓存中读取指定键的值。

DELETE_CACHE - 删除缓存

删除缓存中的指定键值对。

KEYISEXIST - 检查键是否存在

检查指定的键是否存在于缓存中。

NOTEXISTSAVE - 不存在则保存

如果键不存在，则保存数据；如果存在，则返回现有值。

TRYLOCKKEY - 尝试获取锁

尝试获取分布式锁，用于并发控制。

UNLOCKKEY - 释放锁

释放之前获取的分布式锁。

配置参数

CacheAction

基础配置

key：缓存键名（必需）

value：缓存值（保存操作时必需）

expireTime：过期时间（天数，1-180天）

operation：操作类型（自动设置）

使用方法

保存缓存

{
  "key": "user_session_123",
  "value": "{\"userId\":123,\"loginTime\":\"2024-01-01T10:00:00\"}",
  "expireTime": "7"
}

将用户会话数据保存到缓存，有效期7天

读取缓存

{
  "key": "user_session_123"
}

读取用户会话数据

删除缓存

{
  "key": "user_session_123"
}

删除用户会话数据

检查键是否存在

{
  "key": "user_session_123"
}

检查会话是否存在，返回true/false

条件保存

{
  "key": "config_version",
  "value": "v2.1.0",
  "expireTime": "30"
}

如果配置版本不存在则保存，否则返回现有版本

获取分布式锁

{
  "key": "order_lock_456",
  "expireTime": "300"
}

尝试获取订单处理锁，锁超时时间5分钟

释放锁

{
  "key": "order_lock_456"
}

释放订单处理锁

执行逻辑

键名构造

系统自动为键添加前缀，确保多租户隔离：

DATA:CONNECT:{tenantId}:{userKey}

过期时间处理

过期时间单位为天，自动转换为秒

保存时检查剩余过期时间，避免覆盖

最大过期时间180天

锁操作

获取锁时设置等待时间为0（非阻塞）

锁过期时间由expireTime指定

释放锁时检查当前线程是否持有锁

输出结果

CacheOutput格式

{
  "key": "cache_key_name",
  "value": "cached_value_or_result"
}

操作结果说明

SAVE_CACHE：返回保存的键值对

READ_CACHE：返回读取的值（可能为null）

DELETE_CACHE：返回删除前的值

KEYISEXIST：返回true/false

NOTEXISTSAVE：返回保存的值或现有值

TRYLOCKKEY：返回true（获取成功）/false（获取失败）

UNLOCKKEY：返回true（释放成功）

分布式锁特性

锁机制

基于Redis的分布式锁实现

支持可重入锁

自动过期防止死锁

锁超时

锁持有时间由expireTime指定

超过时间自动释放

支持手动释放

并发控制

同一时刻只有一个线程能持有锁

其他线程获取锁失败

适用于高并发场景的数据一致性保证

性能优化

连接池

Redisson自动管理连接池

支持连接复用和负载均衡

自动故障转移

序列化

支持多种数据类型

自动JSON序列化

压缩大对象存储

安全特性

数据隔离

多租户键前缀隔离

防止跨租户数据访问

安全的键名构造

权限控制

基于租户的操作权限

缓存操作审计

敏感数据保护

最佳实践

1. 键名设计

使用有意义的键名

包含业务标识和时间戳

避免过长的键名

2. 过期时间设置

根据业务需求设置合理过期时间

避免设置过长的过期时间

定期清理过期数据

3. 锁使用规范

及时释放锁，避免长时间占用

使用try-finally确保锁释放

设置合理的锁超时时间

4. 错误处理

检查操作结果

处理缓存连接异常

实现降级策略

常见问题

Q: 缓存数据的最大大小是多少？

A: 理论上没有限制，但建议单个缓存值不超过10MB。对于大对象，考虑压缩存储或拆分存储。

Q: 如何处理缓存穿透？

A: 使用NOTEXISTSAVE操作，可以避免缓存穿透。如果键不存在，设置一个短时间的默认值。

Q: 分布式锁的可靠性如何？

A: 基于Redis的Redlock算法实现，具有较高的可靠性。但在网络分区等极端情况下，可能会出现锁失效的情况。

Q: 支持哪些数据类型？

A: 支持所有可序列化的Java对象。系统会自动进行JSON序列化，读取时自动反序列化。

Q: 如何清理过期缓存？

A: Redis自动清理过期键。也可以使用DELETE_CACHE操作手动删除指定缓存。

Q: 锁会自动续期吗？

A: 不会自动续期。锁的持有时间是固定的，超过时间会自动释放。如需延长持有时间，需要重新获取锁。

概述#

功能特性#

支持的操作类型#

SAVE_CACHE - 保存缓存#

READ_CACHE - 读取缓存#

DELETE_CACHE - 删除缓存#

KEYISEXIST - 检查键是否存在#

NOTEXISTSAVE - 不存在则保存#

TRYLOCKKEY - 尝试获取锁#

UNLOCKKEY - 释放锁#

配置参数#

CacheAction#

基础配置#

使用方法#

保存缓存#

读取缓存#

删除缓存#

检查键是否存在#

条件保存#

获取分布式锁#

释放锁#

执行逻辑#

键名构造#

过期时间处理#

锁操作#

输出结果#

CacheOutput格式#

操作结果说明#

分布式锁特性#

锁机制#

锁超时#

并发控制#

性能优化#

连接池#

序列化#

安全特性#

数据隔离#

权限控制#

最佳实践#

1. 键名设计#

2. 过期时间设置#

3. 锁使用规范#

4. 错误处理#

常见问题#

Q: 缓存数据的最大大小是多少？#

Q: 如何处理缓存穿透？#

Q: 分布式锁的可靠性如何？#

Q: 支持哪些数据类型？#

Q: 如何清理过期缓存？#

Q: 锁会自动续期吗？#

概述