Redis 模块

Redis 模块为 XScript 提供 Redis 缓存数据库操作接口,支持字符串、哈希、列表、集合、有序集合等数据结构。

功能特性

连接管理 - 支持多个 Redis 服务器实例

多种数据类型 - String、Hash、List、Set、Sorted Set

发布订阅 - Pub/Sub 消息模式

事务支持 - MULTI/EXEC 事务

持久化 - RDB 和 AOF 持久化

管道操作 - 批量命令执行

Lua 脚本 - 原子性脚本执行

基本使用

引入模块

连接 Redis

字符串操作

哈希操作

列表操作

集合操作

有序集合

发布订阅

事务

管道

API 参考

连接方法

`redis.connect('testServer', config)`

连接 Redis 服务器。

参数:

config (object) - 配置对象

config.name (string) - 服务器名称

config.host (string) - 主机地址

config.port (number) - 端口号,默认 6379

config.password (string) - 密码

config.db (number) - 数据库编号,默认 0

字符串方法

set('testServer', key, value) - 设置值

get('testServer', key) - 获取值

setex('testServer', key, seconds, value) - 设置带过期时间的值

incr('testServer', key) - 自增 1

decr('testServer', key) - 自减 1

哈希方法

hset('testServer', key, field, value) - 设置哈希字段

hget('testServer', key, field) - 获取哈希字段

hmset('testServer', key, object) - 批量设置

hgetall('testServer', key) - 获取所有字段

hdel('testServer', key, field) - 删除字段

列表方法

lpush('testServer', key, value) - 左侧推入

rpush('testServer', key, value) - 右侧推入

lpop('testServer', key) - 左侧弹出

rpop('testServer', key) - 右侧弹出

lrange('testServer', key, start, stop) - 获取范围

集合方法

sadd('testServer', key, member) - 添加成员

smembers('testServer', key) - 获取所有成员

sismember('testServer', key, member) - 检查成员

srem('testServer', key, member) - 删除成员

实际应用场景

会话存储

缓存热点数据

分布式锁

最佳实践

设置过期时间 - 避免内存溢出

使用管道 - 批量操作提高性能

合理使用数据结构 - 选择最适合的数据类型

连接池管理 - 复用连接避免频繁创建

监控内存使用 - 防止内存耗尽

通过 SQL 模块操作 Redis

Redis 提供统一的 SQL 适配层以便与 SQL 模块联动：

说明：

适配层专用表名 redis，通过 key 精确选择

适配范围聚焦 key/value CRUD，不覆盖集合运算、事务或管道语义

redis

Redis 模块#

功能特性#

基本使用#

引入模块#

连接 Redis#

字符串操作#

哈希操作#

列表操作#

集合操作#

有序集合#

发布订阅#

事务#

管道#

API 参考#

连接方法#

redis.connect('testServer', config)#

字符串方法#

哈希方法#

列表方法#

集合方法#

实际应用场景#

会话存储#

缓存热点数据#

分布式锁#

最佳实践#

相关模块#

通过 SQL 模块操作 Redis#