GFramework/GFramework.Core.Godot/system/ResourceFactory.cs

namespace GFramework.Core.Godot.system;

/// <summary>
/// 资源工厂类，用于注册和解析各种资源的创建工厂
/// </summary>
public static class ResourceFactory
{
    /// <summary>
    /// 可预加载条目接口，定义了是否需要预加载以及执行工厂的方法
    /// </summary>
    private interface IPreloadableEntry
    {
        /// <summary>
        /// 获取一个值，表示该资源是否需要预加载
        /// </summary>
        bool Preload { get; }

        /// <summary>
        /// 执行与该条目关联的工厂方法
        /// </summary>
        void ExecuteFactory();
    }

    /// <summary>
    /// 表示一个具体的资源工厂条目，实现 IPreloadableEntry 接口
    /// </summary>
    /// <typeparam name="T">资源类型</typeparam>
    private sealed class Entry<T>(Func<T> factory, bool preload) : IPreloadableEntry
    {
        /// <summary>
        /// 获取用于创建资源的工厂函数
        /// </summary>
        public Func<T> Factory { get; } = factory;

        /// <summary>
        /// 获取一个值，表示该资源是否需要预加载
        /// </summary>
        public bool Preload { get; } = preload;

        /// <summary>
        /// 执行工厂函数以创建资源实例
        /// </summary>
        public void ExecuteFactory() => Factory();
    }
    
    /// <summary>
    /// 工厂注册表，管理所有已注册的资源工厂
    /// </summary>
    internal sealed class Registry
    {
        /// <summary>
        /// 存储所有已注册的工厂函数，键为资源类型，值为对应的工厂条目对象
        /// </summary>
        private readonly Dictionary<Type, object> _factories = new();

        /// <summary>
        /// 注册指定类型的资源工厂
        /// </summary>
        /// <typeparam name="T">要注册的资源类型</typeparam>
        /// <param name="factory">创建该类型资源的工厂函数</param>
        /// <param name="preload">是否需要预加载该资源，默认为false</param>
        public void Register<T>(Func<T> factory, bool preload = false)
        {
            _factories[typeof(T)] = new Entry<T>(factory, preload);
        }

        /// <summary>
        /// 解析并获取指定类型的工厂函数
        /// </summary>
        /// <typeparam name="T">要获取工厂函数的资源类型</typeparam>
        /// <returns>指定类型的工厂函数</returns>
        /// <exception cref="InvalidOperationException">当指定类型的工厂未注册时抛出异常</exception>
        public Func<T> Resolve<T>()
        {
            // 尝试从字典中查找对应类型的工厂条目
            if (_factories.TryGetValue(typeof(T), out var obj)
                && obj is Entry<T> entry)
                return entry.Factory;

            // 若未找到则抛出异常
            throw new InvalidOperationException($"Factory not registered: {typeof(T).Name}");
        }

        /// <summary>
        /// 预加载所有标记为需要预加载的资源
        /// </summary>
        public void PreloadAll()
        {
            // 遍历所有已注册的工厂
            foreach (var entry in _factories.Values)
            {
                // 检查当前条目是否支持预加载且被标记为需预加载
                if (entry is IPreloadableEntry preloadable && preloadable.Preload)
                {
                    // 执行其工厂方法进行预加载
                    preloadable.ExecuteFactory();
                }
            }
        }
    }

}