ResourceCache

命名空间: XCEngine::Resources

类型: class

头文件: XCEngine/Core/Asset/ResourceCache.h

描述: 资源缓存管理器，实现 LRU（最近最少使用）淘汰策略的资源缓存。

概述

ResourceCache 维护了一个内存资源缓存，使用 LRU 策略管理资源条目。当内存使用超过预算时，会自动淘汰最近最少使用的资源。

公共方法

缓存操作

方法	描述
`void Add(ResourceGUID guid, IResource* resource)`	添加资源到缓存
`void Remove(ResourceGUID guid)`	从缓存移除资源
`IResource* Find(ResourceGUID guid) const`	查找缓存中的资源
`void Touch(ResourceGUID guid)`	更新资源的访问时间

缓存信息

方法	描述
`size_t GetSize() const`	获取缓存条目数量
`size_t GetMemoryUsage() const`	获取缓存内存使用量（字节）

内存管理

方法	描述
`void SetMemoryBudget(size_t bytes)`	设置内存预算
`size_t GetMemoryBudget() const`	获取内存预算
`void OnMemoryPressure(size_t requiredBytes)`	内存压力回调，淘汰资源释放内存
`void OnZeroRefCount(ResourceGUID guid)`	引用计数归零时的回调

缓存刷新

方法	描述
`void Flush()`	刷新所有缓存资源
`void Clear()`	清空缓存

LRU 操作

方法	描述
`Containers::Array<ResourceGUID> GetLRUList(size_t count) const`	获取最近最少使用的资源 GUID 列表

实现说明

LRU 策略: 缓存使用 LRU（Least Recently Used）策略淘汰资源。当 OnMemoryPressure() 被调用时，会从最近最少使用的资源开始淘汰，直到释放足够的内存。

线程安全: 缓存操作通过互斥锁保护，部分只读操作使用读锁以提高并发性能。

使用示例

#include <XCEngine/Core/Asset/ResourceCache.h>

using namespace XCEngine::Resources;

// 获取缓存实例（ResourceManager 内部使用）
ResourceCache& cache = /* ... */;

// 设置内存预算 256MB
cache.SetMemoryBudget(256 * 1024 * 1024);

// 手动触发内存压力释放
cache.OnMemoryPressure(50 * 1024 * 1024); // 释放 50MB

// 获取 LRU 列表
auto lruItems = cache.GetLRUList(10);
for (const auto& guid : lruItems) {
    // 处理每个 LRU 条目
}

2.6 KiB Raw Blame History Unescape Escape