游戏客户端架构 / 系统课时

实现资源加载器

实现资源加载器

本课实现一个可扩展的资源加载器:调用方只提交逻辑路径和目标类型,系统负责路径解析、文件读取与类型转换。完成后,新增资源格式不需要修改场景或渲染业务代码。

学习目标

  • 拆分路径解析、字节读取和资源解析职责
  • 使用统一接口加载不同类型的资源
  • 处理加载器缺失、文件不存在和解析失败等边界

明确加载流程

统一加载流程可以分为四步:接收逻辑路径、解析磁盘位置、读取原始字节、交给对应加载器生成资源对象。调用方不应直接执行文件 I/O,也不需要知道某种格式由哪个解析器处理。

统一资源加载流程与组件职责

职责拆分后,各层边界如下:

  • ResourcePathResolver:只负责逻辑路径到磁盘路径
  • IResourceLoader:把文件内容转换为某类资源
  • ResourceManager:注册加载器并协调完整流程
  • 业务代码:只声明“加载什么类型、使用哪个逻辑路径”

定义统一接口

下面的 C++17 示例注册文本和二进制两种加载器。为保持示例可运行,资源统一返回 std::variant<std::string, std::vector<std::byte>>;实际引擎可替换为纹理、音频、场景等专用对象。

cpp
#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';
}

编译并运行:

bash
g++ -std=c++17 -O2 main.cpp -o resource_loader_demo
./resource_loader_demo

预期输出:

text
text: hello resource system
bytes: 21

扩展新的资源类型

新增资源格式时,只需实现 IResourceLoader 并注册。例如图片加载器可以读取字节后调用图像解码库,场景加载器可以解析 JSON 并构造场景数据。ResourceManager 与调用方无需因为格式增加而修改,这正是统一接口的价值。

加载器返回对象之前应完成格式校验。文件存在但内容损坏时,应抛出包含逻辑路径和资源类型的异常;大型引擎还可改用结果类型,显式携带错误码、上下文和可恢复策略。

验收与后续优化

当前实现可通过三个检查验收:同一路径能按不同加载器读取、未注册类型会明确失败、非法逻辑路径无法逃出资源根目录。实际项目还应补充缓存、重复加载合并、异步 I/O 和线程安全。

缓存键建议由“资源类型 + 规范化逻辑路径”组成。否则同一个文件以文本和二进制两种方式加载时,可能错误复用同一缓存对象。

Tips:不要让具体加载器自行决定资源根目录。所有路径都应先经过同一个解析器,才能保证安全规则和缓存键一致。

本课总结

  • 统一资源加载流程应分离路径解析、文件读取、格式解析和流程协调
  • 新资源类型通过实现加载器接口并注册即可接入
  • 明确的错误边界为缓存、异步加载和热重载提供可靠基础

下一课预告

下一课将继续完善资源管理系统,引入缓存与生命周期控制,避免相同资源被重复读取和重复解析。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现资源加载器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通