游戏客户端架构 / 系统课时
实现资源加载器
实现资源加载器
本课实现一个可扩展的资源加载器:调用方只提交逻辑路径和目标类型,系统负责路径解析、文件读取与类型转换。完成后,新增资源格式不需要修改场景或渲染业务代码。
学习目标
- 拆分路径解析、字节读取和资源解析职责
- 使用统一接口加载不同类型的资源
- 处理加载器缺失、文件不存在和解析失败等边界
明确加载流程
统一加载流程可以分为四步:接收逻辑路径、解析磁盘位置、读取原始字节、交给对应加载器生成资源对象。调用方不应直接执行文件 I/O,也不需要知道某种格式由哪个解析器处理。

职责拆分后,各层边界如下:
ResourcePathResolver:只负责逻辑路径到磁盘路径IResourceLoader:把文件内容转换为某类资源ResourceManager:注册加载器并协调完整流程- 业务代码:只声明“加载什么类型、使用哪个逻辑路径”
定义统一接口
下面的 C++17 示例注册文本和二进制两种加载器。为保持示例可运行,资源统一返回 std::variant<std::string, std::vector<std::byte>>;实际引擎可替换为纹理、音频、场景等专用对象。
#include <cstddef>
#include <filesystem>
#include <fstream>
#include <iostream>
#include <memory>
#include <stdexcept>
#include <string>
#include <unordered_map>
#include <variant>
#include <vector>
using ResourceData = std::variant<std::string, std::vector<std::byte>>;
class IResourceLoader {
public:
virtual ~IResourceLoader() = default;
virtual ResourceData load(const std::filesystem::path& path) const = 0;
};
class TextLoader final : public IResourceLoader {
public:
ResourceData load(const std::filesystem::path& path) const override {
std::ifstream input(path);
if (!input) {
throw std::runtime_error("cannot open text resource");
}
return std::string(
std::istreambuf_iterator<char>(input),
std::istreambuf_iterator<char>());
}
};
class BinaryLoader final : public IResourceLoader {
public:
ResourceData load(const std::filesystem::path& path) const override {
std::ifstream input(path, std::ios::binary | std::ios::ate);
if (!input) {
throw std::runtime_error("cannot open binary resource");
}
const auto size = input.tellg();
input.seekg(0);
std::vector<std::byte> bytes(static_cast<std::size_t>(size));
input.read(reinterpret_cast<char*>(bytes.data()), size);
return bytes;
}
};
class ResourceManager {
public:
explicit ResourceManager(std::filesystem::path root)
: root_(std::filesystem::absolute(std::move(root)).lexically_normal()) {}
void registerLoader(std::string type, std::unique_ptr<IResourceLoader> loader) {
loaders_[std::move(type)] = std::move(loader);
}
ResourceData load(const std::string& type, const std::string& logicalPath) const {
const auto loader = loaders_.find(type);
if (loader == loaders_.end()) {
throw std::invalid_argument("no loader registered for type: " + type);
}
return loader->second->load(resolve(logicalPath));
}
private:
std::filesystem::path resolve(const std::string& logicalPath) const {
constexpr const char* prefix = "res://";
if (logicalPath.rfind(prefix, 0) != 0) {
throw std::invalid_argument("resource path must start with res://");
}
const auto path = (root_ / logicalPath.substr(6)).lexically_normal();
auto rootIt = root_.begin();
auto pathIt = path.begin();
for (; rootIt != root_.end(); ++rootIt, ++pathIt) {
if (pathIt == path.end() || *rootIt != *pathIt) {
throw std::invalid_argument("resource path escapes asset root");
}
}
return path;
}
std::filesystem::path root_;
std::unordered_map<std::string, std::unique_ptr<IResourceLoader>> loaders_;
};
int main() {
std::filesystem::create_directories("assets");
std::ofstream("assets/message.txt") << "hello resource system";
ResourceManager manager("assets");
manager.registerLoader("text", std::make_unique<TextLoader>());
manager.registerLoader("binary", std::make_unique<BinaryLoader>());
const auto text = manager.load("text", "res://message.txt");
std::cout << "text: " << std::get<std::string>(text) << '\n';
const auto bytes = manager.load("binary", "res://message.txt");
std::cout << "bytes: " << std::get<std::vector<std::byte>>(bytes).size() << '\n';
}编译并运行:
g++ -std=c++17 -O2 main.cpp -o resource_loader_demo
./resource_loader_demo预期输出:
text: hello resource system
bytes: 21扩展新的资源类型
新增资源格式时,只需实现 IResourceLoader 并注册。例如图片加载器可以读取字节后调用图像解码库,场景加载器可以解析 JSON 并构造场景数据。ResourceManager 与调用方无需因为格式增加而修改,这正是统一接口的价值。
加载器返回对象之前应完成格式校验。文件存在但内容损坏时,应抛出包含逻辑路径和资源类型的异常;大型引擎还可改用结果类型,显式携带错误码、上下文和可恢复策略。
验收与后续优化
当前实现可通过三个检查验收:同一路径能按不同加载器读取、未注册类型会明确失败、非法逻辑路径无法逃出资源根目录。实际项目还应补充缓存、重复加载合并、异步 I/O 和线程安全。
缓存键建议由“资源类型 + 规范化逻辑路径”组成。否则同一个文件以文本和二进制两种方式加载时,可能错误复用同一缓存对象。
Tips:不要让具体加载器自行决定资源根目录。所有路径都应先经过同一个解析器,才能保证安全规则和缓存键一致。
本课总结
- 统一资源加载流程应分离路径解析、文件读取、格式解析和流程协调
- 新资源类型通过实现加载器接口并注册即可接入
- 明确的错误边界为缓存、异步加载和热重载提供可靠基础
下一课预告
下一课将继续完善资源管理系统,引入缓存与生命周期控制,避免相同资源被重复读取和重复解析。