170 lines
3.9 KiB
TypeScript
170 lines
3.9 KiB
TypeScript
// 音乐歌曲信息缓存模块 - 基于 platform+id 的全局缓存
|
|
|
|
// 歌曲信息接口
|
|
export interface SongInfo {
|
|
id: string;
|
|
name: string;
|
|
artist: string;
|
|
album?: string;
|
|
pic?: string;
|
|
}
|
|
|
|
// 缓存条目接口
|
|
export interface SongCacheEntry {
|
|
expiresAt: number;
|
|
data: SongInfo;
|
|
}
|
|
|
|
// 缓存配置
|
|
const SONG_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24小时
|
|
const CACHE_CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // 1小时清理一次
|
|
const MAX_CACHE_SIZE = 5000; // 最大缓存条目数量
|
|
const SONG_CACHE: Map<string, SongCacheEntry> = new Map();
|
|
|
|
// 惰性清理时间戳
|
|
let lastCleanupTime = 0;
|
|
|
|
/**
|
|
* 生成歌曲缓存键：platform+id
|
|
*/
|
|
function makeSongCacheKey(platform: string, id: string): string {
|
|
return `${platform}+${id}`;
|
|
}
|
|
|
|
/**
|
|
* 获取缓存的歌曲信息
|
|
*/
|
|
export function getCachedSong(platform: string, id: string): SongInfo | null {
|
|
const key = makeSongCacheKey(platform, id);
|
|
const entry = SONG_CACHE.get(key);
|
|
if (!entry) return null;
|
|
|
|
// 检查是否过期
|
|
if (entry.expiresAt <= Date.now()) {
|
|
SONG_CACHE.delete(key);
|
|
return null;
|
|
}
|
|
|
|
return entry.data;
|
|
}
|
|
|
|
/**
|
|
* 设置缓存的歌曲信息
|
|
*/
|
|
export function setCachedSong(platform: string, id: string, songInfo: SongInfo): void {
|
|
// 惰性清理：每次写入时检查是否需要清理
|
|
const now = Date.now();
|
|
if (now - lastCleanupTime > CACHE_CLEANUP_INTERVAL_MS) {
|
|
performCacheCleanup();
|
|
}
|
|
|
|
const key = makeSongCacheKey(platform, id);
|
|
SONG_CACHE.set(key, {
|
|
expiresAt: now + SONG_CACHE_TTL_MS,
|
|
data: songInfo,
|
|
});
|
|
}
|
|
|
|
/**
|
|
* 批量获取缓存的歌曲信息
|
|
*/
|
|
export function getCachedSongs(keys: Array<{ platform: string; id: string }>): Map<string, SongInfo> {
|
|
const result = new Map<string, SongInfo>();
|
|
const now = Date.now();
|
|
|
|
for (const { platform, id } of keys) {
|
|
const key = makeSongCacheKey(platform, id);
|
|
const entry = SONG_CACHE.get(key);
|
|
|
|
if (entry && entry.expiresAt > now) {
|
|
result.set(key, entry.data);
|
|
}
|
|
}
|
|
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 批量设置缓存的歌曲信息
|
|
*/
|
|
export function setCachedSongs(songs: Array<{ platform: string; id: string; songInfo: SongInfo }>): void {
|
|
const now = Date.now();
|
|
|
|
// 惰性清理
|
|
if (now - lastCleanupTime > CACHE_CLEANUP_INTERVAL_MS) {
|
|
performCacheCleanup();
|
|
}
|
|
|
|
for (const { platform, id, songInfo } of songs) {
|
|
const key = makeSongCacheKey(platform, id);
|
|
SONG_CACHE.set(key, {
|
|
expiresAt: now + SONG_CACHE_TTL_MS,
|
|
data: songInfo,
|
|
});
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 智能清理过期的缓存条目
|
|
*/
|
|
function performCacheCleanup(): { expired: number; total: number; sizeLimited: number } {
|
|
const now = Date.now();
|
|
const keysToDelete: string[] = [];
|
|
let sizeLimitedDeleted = 0;
|
|
|
|
// 1. 清理过期条目
|
|
SONG_CACHE.forEach((entry, key) => {
|
|
if (entry.expiresAt <= now) {
|
|
keysToDelete.push(key);
|
|
}
|
|
});
|
|
|
|
const expiredCount = keysToDelete.length;
|
|
keysToDelete.forEach(key => SONG_CACHE.delete(key));
|
|
|
|
// 2. 如果缓存大小超限，清理最老的条目（LRU策略）
|
|
if (SONG_CACHE.size > MAX_CACHE_SIZE) {
|
|
const entries = Array.from(SONG_CACHE.entries());
|
|
// 按照过期时间排序，最早过期的在前面
|
|
entries.sort((a, b) => a[1].expiresAt - b[1].expiresAt);
|
|
|
|
const toRemove = SONG_CACHE.size - MAX_CACHE_SIZE;
|
|
for (let i = 0; i < toRemove; i++) {
|
|
SONG_CACHE.delete(entries[i][0]);
|
|
sizeLimitedDeleted++;
|
|
}
|
|
}
|
|
|
|
lastCleanupTime = now;
|
|
|
|
return {
|
|
expired: expiredCount,
|
|
total: SONG_CACHE.size,
|
|
sizeLimited: sizeLimitedDeleted
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 清除所有歌曲缓存
|
|
*/
|
|
export function clearSongCache(): { cleared: number } {
|
|
const size = SONG_CACHE.size;
|
|
SONG_CACHE.clear();
|
|
return { cleared: size };
|
|
}
|
|
|
|
/**
|
|
* 获取缓存统计信息
|
|
*/
|
|
export function getSongCacheStats(): {
|
|
size: number;
|
|
maxSize: number;
|
|
ttlMs: number;
|
|
} {
|
|
return {
|
|
size: SONG_CACHE.size,
|
|
maxSize: MAX_CACHE_SIZE,
|
|
ttlMs: SONG_CACHE_TTL_MS,
|
|
};
|
|
}
|