缓存列表处理

概述

列表缓存处理器，专门用于处理Redis中的列表数据结构。支持列表的添加、读取操作，并提供列表大小限制和过期时间管理功能。

功能特性

列表操作：支持列表元素添加和读取

大小限制：自动维护列表最大长度

过期管理：支持设置列表过期时间

高性能：基于Redisson的列表操作

数据持久：列表数据在Redis中持久化存储

支持的操作类型

LPUSH_LIST - 左推列表

向列表左侧添加元素，支持批量添加，并自动截断超出最大长度的元素。

READ_LIST - 读取列表

读取列表中的所有元素。

配置参数

CacheListAction

基础配置

key：缓存键名（必需）

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

maxSize：列表最大长度（默认16）

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

数据配置（LPUSH_LIST时必需）

value：要添加的字符串列表

使用方法

添加列表元素

{
  "key": "recent_logs",
  "value": ["用户登录", "数据更新", "文件上传"],
  "maxSize": 100,
  "expireTime": 7
}

向recent_logs列表添加3个元素，保持最大长度100，过期时间7天

读取列表内容

{
  "key": "recent_logs"
}

读取recent_logs列表的所有元素

消息队列实现

{
  "key": "message_queue",
  "value": ["{\"id\":1,\"content\":\"新消息\"}"],
  "maxSize": 1000,
  "expireTime": 1
}

实现简单的消息队列，最大1000条消息，1天过期

操作日志记录

{
  "key": "operation_log",
  "value": ["用户A删除了文件X"],
  "maxSize": 500,
  "expireTime": 30
}

记录用户操作日志，最多保留500条，30天过期

执行逻辑

列表构造

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

DATA:CONNECT:{tenantId}:{userKey}

LPUSH_LIST操作流程

获取或创建Redis列表

将所有元素添加到列表左侧

检查列表长度是否超过maxSize

如果超过，截断右侧多余元素

设置或更新过期时间

READ_LIST操作流程

获取Redis列表

返回列表中的所有元素（从左到右）

如果列表不存在，返回空列表

输出结果

CacheOutput格式

{
  "key": "list_key_name",
  "value": ["item1", "item2", "item3"]
}

操作结果说明

LPUSH_LIST：返回添加的元素列表

READ_LIST：返回列表中的所有元素

列表特性

存储结构

基于Redis List数据结构

元素按添加顺序存储

支持从两端操作（LPUSH/RPUSH）

大小管理

自动截断超出maxSize的元素

保留最新的maxSize个元素

截断从右侧（最旧的）开始

过期机制

整个列表设置过期时间

过期后整个列表被删除

支持续期（重新操作时更新过期时间）

性能优化

批量操作

支持一次添加多个元素

减少网络往返次数

提高操作效率

内存管理

限制列表最大长度

自动清理过期列表

合理的序列化策略

最佳实践

1. 列表大小设置

根据业务需求设置maxSize

避免设置过大的maxSize

定期评估和调整大小限制

2. 过期时间管理

设置合理的过期时间

根据数据重要性调整

避免长期保留不必要数据

3. 键名设计

使用清晰的业务含义

包含时间或其他标识

便于管理和维护

4. 错误处理

检查操作结果

处理列表不存在的情况

实现异常降级策略

应用场景

消息队列

任务队列

事件队列

通知队列

日志记录

操作日志

访问日志

错误日志

缓存列表

会话管理

用户操作历史

会话步骤记录

状态流转记录

调试和监控

列表操作日志

记录添加/读取操作详情

输出列表长度和操作结果

记录过期时间设置

性能指标

列表操作响应时间

列表平均长度

过期列表清理统计

常见问题

Q: 列表元素如何排序？

A: 元素按添加时间倒序排列，最新的元素在左侧。LPUSH操作添加到左侧，读取时从左到右返回。

Q: 超过maxSize怎么办？

A: 系统自动截断右侧的旧元素，保持列表长度不超过maxSize。只保留最新的maxSize个元素。

Q: 支持哪些数据类型？

A: 当前版本只支持字符串列表。复杂对象需要先序列化为JSON字符串再存储。

Q: 如何实现FIFO队列？

A: 使用LPUSH添加元素（到左侧），使用Redis的RPOP操作（从右侧弹出）可以实现FIFO队列。

Q: 列表过期后会发生什么？

A: 整个列表及其所有元素会被Redis自动删除。下次操作时相当于空列表。

Q: 如何查看列表长度？

A: 使用READ_LIST操作可以获取完整列表，应用层可以计算列表长度。未来版本会增加长度查询功能。

概述#

功能特性#

支持的操作类型#

LPUSH_LIST - 左推列表#

READ_LIST - 读取列表#

配置参数#

CacheListAction#

基础配置#

数据配置（LPUSH_LIST时必需）#

使用方法#

添加列表元素#

读取列表内容#

消息队列实现#

操作日志记录#

执行逻辑#

列表构造#

LPUSH_LIST操作流程#

READ_LIST操作流程#

输出结果#

CacheOutput格式#

操作结果说明#

列表特性#

存储结构#

大小管理#

过期机制#

性能优化#

批量操作#

内存管理#

最佳实践#

1. 列表大小设置#

2. 过期时间管理#

3. 键名设计#

4. 错误处理#

应用场景#

消息队列#

日志记录#

缓存列表#

会话管理#

调试和监控#

列表操作日志#

性能指标#

常见问题#

Q: 列表元素如何排序？#

Q: 超过maxSize怎么办？#

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

Q: 如何实现FIFO队列？#

Q: 列表过期后会发生什么？#

Q: 如何查看列表长度？#

概述