108 lines
2.6 KiB
JavaScript
108 lines
2.6 KiB
JavaScript
/**
|
|
* @fileoverview 基于内存的缓存实现
|
|
*
|
|
* 提供简单的键值对缓存，支持：
|
|
* - 按时间自动过期（通过 setTimeout 实现）
|
|
* - 过期回调通知
|
|
* - 批量清除
|
|
*
|
|
* 作为 apicache 的底层存储引擎使用。
|
|
*
|
|
* @module memory-cache
|
|
*/
|
|
|
|
/**
|
|
* MemoryCache 构造函数
|
|
*
|
|
* 初始化空的缓存存储和计数器。
|
|
* @constructor
|
|
*/
|
|
function MemoryCache() {
|
|
this.cache = {}; // 缓存数据存储 { key: { value, expire, timeout } }
|
|
this.size = 0; // 当前缓存条目数
|
|
}
|
|
|
|
/**
|
|
* 添加缓存条目
|
|
*
|
|
* @param {string} key - 缓存键
|
|
* @param {*} value - 缓存值（任意类型）
|
|
* @param {number} time - 过期时间（毫秒）
|
|
* @param {function} [timeoutCallback] - 过期时的回调函数 (value, key) => void
|
|
* @returns {Object} 创建的缓存条目 { value, expire, timeout }
|
|
*/
|
|
MemoryCache.prototype.add = function (key, value, time, timeoutCallback) {
|
|
const old = this.cache[key];
|
|
const instance = this;
|
|
|
|
const entry = {
|
|
value, // 缓存的值
|
|
expire: time + Date.now(), // 过期时间戳（毫秒）
|
|
timeout: setTimeout(function () {
|
|
// 自动过期：删除条目并触发回调
|
|
instance.delete(key);
|
|
return timeoutCallback && typeof timeoutCallback === 'function' && timeoutCallback(value, key);
|
|
}, time),
|
|
};
|
|
|
|
this.cache[key] = entry;
|
|
this.size = Object.keys(this.cache).length;
|
|
|
|
return entry;
|
|
};
|
|
|
|
/**
|
|
* 删除缓存条目
|
|
*
|
|
* @param {string} key - 缓存键
|
|
* @returns {null} 始终返回 null
|
|
*/
|
|
MemoryCache.prototype.delete = function (key) {
|
|
const entry = this.cache[key];
|
|
if (entry) clearTimeout(entry.timeout); // 清除自动过期定时器
|
|
|
|
delete this.cache[key];
|
|
|
|
this.size = Object.keys(this.cache).length;
|
|
|
|
return null;
|
|
};
|
|
|
|
/**
|
|
* 获取缓存条目（包含元数据）
|
|
*
|
|
* @param {string} key - 缓存键
|
|
* @returns {Object|undefined} 缓存条目 { value, expire, timeout }，不存在返回 undefined
|
|
*/
|
|
MemoryCache.prototype.get = function (key) {
|
|
return this.cache[key];
|
|
};
|
|
|
|
/**
|
|
* 获取缓存的值（仅返回 value 部分）
|
|
*
|
|
* @param {string} key - 缓存键
|
|
* @returns {*} 缓存的值，不存在返回 undefined
|
|
*/
|
|
MemoryCache.prototype.getValue = function (key) {
|
|
const entry = this.get(key);
|
|
|
|
return entry && entry.value;
|
|
};
|
|
|
|
/**
|
|
* 清除所有缓存条目
|
|
*
|
|
* 遍历所有键并逐个删除（会清除对应的定时器）。
|
|
* @returns {true} 始终返回 true
|
|
*/
|
|
MemoryCache.prototype.clear = function () {
|
|
Object.keys(this.cache).forEach(function (key) {
|
|
this.delete(key);
|
|
}, this);
|
|
|
|
return true;
|
|
};
|
|
|
|
module.exports = MemoryCache;
|