89 lines
2.6 KiB
Markdown
89 lines
2.6 KiB
Markdown
# 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()` 被调用时，会从最近最少使用的资源开始淘汰，直到释放足够的内存。
|
||
|
||
**线程安全**: 缓存操作通过互斥锁保护，部分只读操作使用读锁以提高并发性能。
|
||
|
||
## 使用示例
|
||
|
||
```cpp
|
||
#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 条目
|
||
}
|
||
```
|
||
|
||
## 相关文档
|
||
|
||
- [ResourceManager](resource-manager/resource-manager.md) - 资源管理器
|
||
- [IResource](iresource/iresource.md) - 资源基类
|
||
- [Resources 总览](resources.md) - 返回模块总览
|