后端缓存

本文档介绍后端缓存相关 JS 工具方法，底层基于 Redis 实现。

缓存概述

Redis 是开源高性能 Key-Value 数据库，具备以下特性：

• 支持数据持久化，可将内存数据落盘，服务重启后恢复数据；
• 除基础 Key-Value 外，支持 List、Set、ZSet、Hash 等多种数据结构；
• 支持主从模式，实现数据备份。

cache_getserver

读取后端 Redis 缓存数据。

语法

cache_getserver(key)

参数

参数名	类型	必填	说明
key	string	是	缓存键名

示例

var str = cache_getserver('key');
var data = JSON.parse(str);

---

cache_setserver

写入后端 Redis 缓存数据。

语法

cache_setserver(key, value, seconds)

参数

参数名	类型	必填	说明
key	string	是	缓存键名
value	string	是	缓存内容；对象需先用 JSON.stringify 序列化为字符串
seconds	number	是	缓存有效期，单位：秒

示例

var data = {
  name: '张三',
  age: 18
};
cache_setserver('key', JSON.stringify(data), 60);

---

cache_remove_server

删除后端 Redis 指定缓存数据。

语法

cache_remove_server(key)

参数

参数名	类型	必填	说明
key	string	是	缓存键名

---

cache_lockserver

写入带互斥锁的 Redis 缓存（NX 原子锁）。

说明：仅当 key 不存在时才能设置成功；key 未被删除前，无法重复覆盖，适用于防重复并发场景。

语法

cache_lockserver(key, value, seconds)

参数

参数名	类型	必填	说明
key	string	是	缓存键名
value	string	是	缓存内容；对象需先用 JSON.stringify 序列化为字符串
seconds	number	是	缓存有效期，单位：秒

示例

var data = {
  name: '张三',
  age: 18
};
// 尝试设置缓存，成功返回 true，失败返回 false
var result = cache_lockserver('key', JSON.stringify(data), 60);
console.log("cache_lockserver result:", result);