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();
}
}
}