# 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) - 返回模块总览