using Data; using System; using System.Collections; using System.Collections.Generic; using System.Linq; using System.Reflection; using UnityEngine; using Utils; namespace Managers { /// /// 定义管理器,负责加载、管理和查询所有数据定义(Define)对象。 /// /// /// 该管理器是一个单例,用于在应用程序中集中管理各种游戏或系统定义, /// 包括从不同数据包(Mods)加载定义,处理定义之间的引用,以及提供多种查询方法。 /// public class DefineManager : Singleton, ILaunchManager { /// /// 数据集文件路径数组,用于指定定义包的根目录。 /// private static readonly string[] dataSetFilePath = { "Data", "Mods" }; /// /// 存储所有按类别和定义名索引的定义。 /// /// /// 外层字典的键是定义类别(例如,类的类型名),内层字典的键是定义的名称。 /// public Dictionary> defines = new(); /// /// 存储所有按包ID索引的定义包。 /// /// /// 键是定义包的唯一ID,值是对应的 对象。 /// public Dictionary packs = new(); /// /// 存储所有按类别索引的匿名定义列表。 /// /// /// 匿名定义是没有明确 的定义,它们通常作为其他定义的子元素出现。 /// 外层字典的键是定义类别,值是该类别下的匿名定义列表。 /// public Dictionary> anonymousDefines = new(); public string StepDescription => "加载数据定义中"; /// /// 初始化定义管理器,加载所有定义包并构建定义字典。 /// /// /// 该方法执行以下操作: /// /// 获取指定路径下的所有子文件夹,每个子文件夹代表一个定义包。 /// 遍历每个定义包,尝试加载其中的定义数据。 /// 将加载的定义数据按类型分类,并存储到定义字典中。 /// 处理定义内部的引用关系,将引用占位符替换为实际定义对象。 /// /// public void Init() { if (packs.Count > 0) return; // 获取所有定义包的文件夹路径 var packFolder = Configs.ConfigProcessor.GetSubFolders(new(dataSetFilePath)); foreach (var folder in packFolder) { var pack = new DefinePack(); if (pack.LoadPack(folder)) { packs.Add(pack.packID, pack); } } // 字段信息缓存,用于优化反射性能。 Dictionary fieldCache = new(); // 存储需要进行链接的定义引用信息。 // Tuple的元素依次代表:被引用的定义(Define),引用该定义的字段(FieldInfo),以及引用占位符(Define)。 List> defineCache = new(); string currentPackID; // 递归处理定义对象及其内部的嵌套定义和引用。 void ProcessDefine(Define def) { if (def == null || def.isReferene) return; def.packID = currentPackID; // 检查是否已缓存字段信息,如果已缓存则直接使用。 if (!fieldCache.TryGetValue(def.GetType(), out var defineFields)) { // 获取所有公共实例字段。 defineFields = def.GetType() .GetFields(BindingFlags.Public | BindingFlags.Instance); // 缓存当前类型的字段信息。 fieldCache[def.GetType()] = defineFields; } foreach (var defineField in defineFields) { var fieldType = defineField.FieldType; // 处理单个 Define 类型的字段 if (typeof(Define).IsAssignableFrom(fieldType)) { var defRef = (Define)defineField.GetValue(def); if (defRef == null) continue; if (defRef.isReferene) { defineCache.Add(new Tuple(def, defineField, defRef)); } else { if (string.IsNullOrEmpty(defRef.defName)) { var typeName = defRef.GetType().Name; if (!anonymousDefines.ContainsKey(typeName)) anonymousDefines.Add(typeName, new List()); anonymousDefines[typeName].Add(defRef); } ProcessDefine(defRef); } } // 处理 List 类型的字段 else if (fieldType.IsGenericType && fieldType.GetGenericTypeDefinition() == typeof(List<>)) { var elementType = fieldType.GenericTypeArguments[0]; if (typeof(Define).IsAssignableFrom(elementType)) { var list = (IList)defineField.GetValue(def); if (list != null) { foreach (var item in list) { if (item is Define { isReferene: false } defItem) { ProcessDefine(defItem); } } } } } // 处理 Define[] 类型的数组字段 else if (fieldType.IsArray) { var elementType = fieldType.GetElementType(); if (typeof(Define).IsAssignableFrom(elementType)) { var array = (Array)defineField.GetValue(def); if (array != null) { foreach (var item in array) { if (item is Define { isReferene: false } defItem) { ProcessDefine(defItem); } } } } } } } foreach (var pack in packs) { currentPackID = pack.Value.packID; foreach (var (typeName, defList) in pack.Value.defines) { if (!defines.ContainsKey(typeName)) defines[typeName] = new Dictionary(); foreach (var def in defList) { defines[typeName][def.defName] = def; ProcessDefine(def); } } } // 处理所有定义间的引用关系 foreach (var defRef in defineCache) { if (defRef.Item1 == null) { Debug.LogError("被引用定义为 null!"); continue; } if (defRef.Item2 == null) { Debug.LogError("被引用定义的字段引用为 null!"); continue; } var value = FindDefine(defRef.Item3.description, defRef.Item3.defName); if (value == null) { Debug.LogError($"未找到引用,出错的定义:定义类型:{defRef.Item1.GetType().Name}, 定义名:{defRef.Item1.defName} ; 类型:{defRef.Item3.description}, 定义名:{defRef.Item3.defName}"); continue; } try { defRef.Item2.SetValue(defRef.Item1, value); } catch (Exception ex) { Debug.LogError($"SetValue 出错: {ex.Message}"); } } } public void Clear() { defines.Clear(); packs.Clear(); anonymousDefines.Clear(); } /// /// 查找指定定义类型的定义名对应的 对象。 /// /// 定义类型(通常是类的名称)。 /// 定义名。 /// 如果找到,返回 对象;否则返回 null。 public Define FindDefine(string defineType, string defineName) { if (defines.TryGetValue(defineType, out var typeDict)) { if (typeDict.TryGetValue(defineName, out var define)) { return define; } } return null; } /// /// 使用泛型模板查找并返回指定类型的 对象。 /// /// 目标类型,必须继承自 /// 定义名。 /// 如果找到,返回转换为目标类型的 对象;否则返回 null。 public T FindDefine(string defineName) where T : Define { if (defines.TryGetValue(typeof(T).Name, out var typeDict)) { if (typeDict.TryGetValue(defineName, out var define)) { return (T)define; } } return null; } /// /// 获取指定 对象所属的定义包。 /// /// 要查询的 对象。 /// 如果找到对应的定义包,则返回 对象;否则返回 null。 public DefinePack GetDefinePackage(Define define) { if (define == null || define.packID == null) return null; packs.TryGetValue(define.packID, out var pack); return pack; } /// /// 获取指定 对象所属定义包的名称。 /// /// 要查询的 对象。 /// 如果找到对应的定义包,则返回其名称;否则返回 null。 public string GetDefinePackageName(Define define) { return GetDefinePackage(define)?.Name; } /// /// 获取指定包ID对应定义包的根路径。 /// /// 定义包的唯一标识ID。 /// 如果找到对应的定义包,则返回其根路径;否则返回 null。 public string GetPackagePath(string packID) { if (packs.TryGetValue(packID, out var pack)) { return pack.packRootPath; } return null; } /// /// 获取所有已加载的 对象。 /// /// 包含所有命名定义和匿名定义的数组。 public Define[] GetAllDefine() { List defineList = new(); foreach (var define in defines.Values) { defineList.AddRange(define.Values); } foreach (var anonymousDefine in anonymousDefines) { defineList.AddRange(anonymousDefine.Value); } return defineList.ToArray(); } /// /// 查询指定类型下的所有 对象(包括命名定义和匿名定义)。 /// /// 定义类型(外层字典的键,通常是类的名称)。 /// 该类型下的 数组。如果未找到任何定义,则返回 null。 public Define[] QueryDefinesByType(string defineType) { if (string.IsNullOrEmpty(defineType)) { Debug.LogError("查询失败:定义类型参数不能为空!"); return null; } var result = new List(); // 从命名定义中查询。 if (defines.TryGetValue(defineType, out var namedDefinitions)) { result.AddRange(namedDefinitions.Values); } // 从匿名定义中查询。 if (anonymousDefines.TryGetValue(defineType, out var anonymousDefinitionList)) { result.AddRange(anonymousDefinitionList); } // 如果结果为空,则返回 null。 if (result.Count == 0) { Debug.LogWarning($"查询失败:未找到定义类型 '{defineType}'"); return null; } return result.ToArray(); } /// /// 查询指定类型下的所有 对象,并尝试转换为目标类型(包括命名定义和匿名定义)。 /// /// 目标类型,必须继承自 /// 转换后的目标类型数组。如果未找到或转换失败,则返回 null。 public T[] QueryDefinesByType() where T : Define { var defineType = typeof(T).Name; var allDefines = QueryDefinesByType(defineType)?.ToList(); if (allDefines == null || allDefines.Count == 0) { return null; } try { // 尝试将所有 对象转换为目标类型 T。 var result = new List(); foreach (var item in allDefines) { if (item is T converted) { result.Add(converted); } else { Debug.LogError($"类型转换失败:无法将 {item.GetType().Name} 转换为 {typeof(T).Name}"); return null; } } return result.ToArray(); } catch (Exception ex) { Debug.LogError($"类型转换失败:从 Define 转换为 {typeof(T).Name} 时出错。错误信息:{ex.Message}"); return null; } } /// /// 查询指定类型下的所有命名 对象(不包括匿名定义)。 /// /// 定义类型(外层字典的键,通常是类的名称)。 /// 该类型下的命名 数组。如果未找到任何命名定义,则返回 null。 public Define[] QueryNamedDefinesByType(string defineType) { if (string.IsNullOrEmpty(defineType)) { Debug.LogError("查询失败:定义类型参数不能为空!"); return null; } var result = new List(); // 仅从命名定义中查询。 if (defines.TryGetValue(defineType, out var namedDefinitions)) { result.AddRange(namedDefinitions.Values); } // 如果结果为空,则返回 null。 if (result.Count == 0) { Debug.LogWarning($"查询失败:未找到定义类型 '{defineType}' 的命名定义"); return null; } return result.ToArray(); } /// /// 查询指定类型下的所有命名 对象,并尝试转换为目标类型(不包括匿名定义)。 /// /// 目标类型,必须继承自 /// 转换后的目标类型数组。如果未找到或转换失败,则返回 null。 public T[] QueryNamedDefinesByType() where T : Define { var defineType = typeof(T).Name; var allDefines = QueryNamedDefinesByType(defineType)?.ToList(); if (allDefines == null || allDefines.Count == 0) { return null; } try { // 尝试将所有 对象转换为目标类型 T。 var result = new List(); foreach (var item in allDefines) { if (item is T converted) { result.Add(converted); } else { Debug.LogError($"类型转换失败:无法将 {item.GetType().Name} 转换为 {typeof(T).Name}"); return null; } } return result.ToArray(); } catch (Exception ex) { Debug.LogError($"类型转换失败:从 Define 转换为 {typeof(T).Name} 时出错。错误信息:{ex.Message}"); return null; } } /// /// 返回所有加载的定义包的字符串表示。 /// /// 一个包含所有定义包信息的字符串,每个包信息占一行。 public override string ToString() { if (packs == null || packs.Count == 0) { // 如果集合为空或为 null,返回默认信息。 return "No packs available"; } var result = new System.Text.StringBuilder(); foreach (var definePack in packs) { // 每个定义包对象占一行。 result.AppendLine(definePack.ToString()); } return result.ToString(); } } }