109 lines
2.5 KiB
TypeScript
109 lines
2.5 KiB
TypeScript
|
interface CacheItem<T> {
|
|||
|
|
value: T
|
|||
|
|
expiry?: number // 过期时间戳（毫秒），可选
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 通用缓存管理类（支持过期时间，不设 TTL 即为永久缓存）
|
|||
|
|
*/
|
|||
|
|
class CacheManager {
|
|||
|
|
/**
|
|||
|
|
* 设置缓存
|
|||
|
|
* @param key 缓存键
|
|||
|
|
* @param value 缓存值
|
|||
|
|
* @param ttl 过期时间（秒）。若为 undefined、null 或 <=0，则视为永久缓存（永不过期）
|
|||
|
|
*/
|
|||
|
|
static set<T>(key: string, value: T, ttl?: number | null): void {
|
|||
|
|
try {
|
|||
|
|
const cacheItem: CacheItem<T> = { value }
|
|||
|
|
|
|||
|
|
// 仅当 ttl 为正数时才设置过期时间
|
|||
|
|
if (ttl != null && ttl > 0) {
|
|||
|
|
cacheItem.expiry = Date.now() + ttl * 1000
|
|||
|
|
}
|
|||
|
|
// 否则 cacheItem.expiry 保持 undefined，表示永久缓存
|
|||
|
|
|
|||
|
|
uni.setStorageSync(key, cacheItem)
|
|||
|
|
}
|
|||
|
|
catch (e) {
|
|||
|
|
console.error('CacheManager.set error:', e)
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 获取缓存（自动清除过期项）
|
|||
|
|
* @param key 缓存键
|
|||
|
|
* @param defaultValue 默认值（缓存不存在、过期或出错时返回）
|
|||
|
|
* @returns 缓存值或默认值
|
|||
|
|
*/
|
|||
|
|
static get<T>(key: string, defaultValue: T = null as unknown as T): T {
|
|||
|
|
try {
|
|||
|
|
const raw = uni.getStorageSync(key)
|
|||
|
|
if (!raw)
|
|||
|
|
return defaultValue
|
|||
|
|
|
|||
|
|
const cacheItem = raw as CacheItem<T>
|
|||
|
|
|
|||
|
|
// 若有 expiry 且已过期，则清除并返回默认值
|
|||
|
|
if (cacheItem.expiry !== undefined && Date.now() > cacheItem.expiry) {
|
|||
|
|
uni.removeStorageSync(key)
|
|||
|
|
return defaultValue
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return cacheItem.value
|
|||
|
|
}
|
|||
|
|
catch (e) {
|
|||
|
|
console.error('CacheManager.get error:', e)
|
|||
|
|
return defaultValue
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 删除指定缓存
|
|||
|
|
*/
|
|||
|
|
static remove(key: string): void {
|
|||
|
|
try {
|
|||
|
|
uni.removeStorageSync(key)
|
|||
|
|
}
|
|||
|
|
catch (e) {
|
|||
|
|
console.error('CacheManager.remove error:', e)
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 清空所有缓存
|
|||
|
|
*/
|
|||
|
|
static clear(): void {
|
|||
|
|
try {
|
|||
|
|
uni.clearStorageSync()
|
|||
|
|
}
|
|||
|
|
catch (e) {
|
|||
|
|
console.error('CacheManager.clear error:', e)
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* 检查是否存在有效（未过期）缓存
|
|||
|
|
*/
|
|||
|
|
static has(key: string): boolean {
|
|||
|
|
try {
|
|||
|
|
const raw = uni.getStorageSync(key)
|
|||
|
|
if (!raw)
|
|||
|
|
return false
|
|||
|
|
|
|||
|
|
const cacheItem = raw as CacheItem<unknown>
|
|||
|
|
if (cacheItem.expiry !== undefined && Date.now() > cacheItem.expiry) {
|
|||
|
|
uni.removeStorageSync(key)
|
|||
|
|
return false
|
|||
|
|
}
|
|||
|
|
return true
|
|||
|
|
}
|
|||
|
|
catch (e) {
|
|||
|
|
console.error('CacheManager.has error:', e)
|
|||
|
|
return false
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export default CacheManager
|