Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

3.8 KB
Raw Blame
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
/**
 * @file    LoaderRegistry.hpp
 * @brief   Registry for resource loaders
 * @details Manages registration and lookup of resource loaders by type.
 *
 * @author  ESEngine Team
 * @date    2026
 *
 * @copyright Copyright (c) 2026 ESEngine Team
 *            Licensed under the Apache License, Version 2.0.
 */
#pragma once

// =============================================================================
// Includes
// =============================================================================

#include "../core/Types.hpp"
#include "ResourceLoader.hpp"

#include <unordered_map>

namespace esengine::resource {

// =============================================================================
// LoaderRegistry Class
// =============================================================================

/**
 * @brief Registry for managing resource loaders
 *
 * @details Stores loaders by resource type and provides lookup functionality.
 *          Use with ResourceManager for a complete resource loading system.
 *
 * @code
 * LoaderRegistry registry;
 * registry.registerLoader<Texture>(makeUnique<MyTextureLoader>());
 *
 * auto* loader = registry.getLoader<Texture>();
 * if (loader && loader->canLoad("my.png")) {
 *     auto result = loader->load({"my.png"});
 * }
 * @endcode
 */
class LoaderRegistry {
public:
    LoaderRegistry() = default;
    ~LoaderRegistry() = default;

    LoaderRegistry(const LoaderRegistry&) = delete;
    LoaderRegistry& operator=(const LoaderRegistry&) = delete;
    LoaderRegistry(LoaderRegistry&&) = default;
    LoaderRegistry& operator=(LoaderRegistry&&) = default;

    /**
     * @brief Registers a loader for a resource type
     * @tparam T Resource type
     * @param loader The loader instance to register
     */
    template<typename T>
    void registerLoader(Unique<ResourceLoader<T>> loader) {
        auto wrapper = makeUnique<LoaderWrapper<T>>(std::move(loader));
        loaders_[resourceTypeId<T>()] = std::move(wrapper);
    }

    /**
     * @brief Gets the loader for a resource type
     * @tparam T Resource type
     * @return Pointer to the loader, or nullptr if not registered
     */
    template<typename T>
    ResourceLoader<T>* getLoader() {
        auto it = loaders_.find(resourceTypeId<T>());
        if (it == loaders_.end()) {
            return nullptr;
        }
        auto* wrapper = static_cast<LoaderWrapper<T>*>(it->second.get());
        return wrapper->get();
    }

    /**
     * @brief Gets the loader for a resource type (const)
     * @tparam T Resource type
     * @return Const pointer to the loader, or nullptr if not registered
     */
    template<typename T>
    const ResourceLoader<T>* getLoader() const {
        auto it = loaders_.find(resourceTypeId<T>());
        if (it == loaders_.end()) {
            return nullptr;
        }
        auto* wrapper = static_cast<const LoaderWrapper<T>*>(it->second.get());
        return wrapper->get();
    }

    /**
     * @brief Checks if a loader is registered for a type
     * @tparam T Resource type
     * @return True if a loader is registered
     */
    template<typename T>
    bool hasLoader() const {
        return loaders_.find(resourceTypeId<T>()) != loaders_.end();
    }

    /**
     * @brief Removes a loader for a type
     * @tparam T Resource type
     */
    template<typename T>
    void removeLoader() {
        loaders_.erase(resourceTypeId<T>());
    }

    /**
     * @brief Clears all registered loaders
     */
    void clear() {
        loaders_.clear();
    }

    /**
     * @brief Gets the number of registered loaders
     * @return Number of loaders
     */
    usize size() const {
        return loaders_.size();
    }

private:
    std::unordered_map<TypeId, Unique<ILoaderBase>> loaders_;
};

}  // namespace esengine::resource