(client) feat: Improve map generation logic (#36)

Co-authored-by: zzdxxz <2079238449@qq.com>
Co-committed-by: zzdxxz <2079238449@qq.com>

Client/Assets/Scripts/Data/DefinePack.cs

@@ -141,19 +141,34 @@ namespace Data
                 var className = element.Name.ToString();
                 if (string.IsNullOrEmpty(className))
                     continue;
-                // Debug.Log("1");
                 var def = LoadDefineClass(element,element.Name.ToString());
                 if (def == null)
                     continue;
-                // Debug.Log("2");
+                def.packID = packID;
                 if (!defines.ContainsKey(className))
                     defines.Add(className, new List<Define>());
                 defines[className].Add(def);
-                // Debug.Log($"插入{className},{def.defName}");
             }
         }
-
-        private static Define LoadDefineClass(XElement defineDoc,string className)
+        /// <summary>
+        /// 根据指定的 XML 元素 (<paramref name="defineDoc"/>) 和类名 (<paramref name="className"/>),
+        /// 动态加载并初始化一个继承自 <see cref="Define"/> 的类实例。
+        /// </summary>
+        /// <param name="defineDoc">包含类定义的 XML 元素 (<see cref="XElement"/>)。</param>
+        /// <param name="className">目标类的全限定名或简短名称。</param>
+        /// <returns>
+        /// 如果成功加载并初始化，则返回对应的 <see cref="Define"/> 类实例；
+        /// 否则返回 null。
+        /// </returns>
+        /// <exception cref="ArgumentNullException">
+        /// 如果 <paramref name="defineDoc"/> 或 <paramref name="className"/> 为 null 或空字符串，则抛出此异常。
+        /// </exception>
+        /// <remarks>
+        /// 该方法通过反射动态加载指定类，并检查其是否继承自 <see cref="Define"/>。
+        /// 如果类存在且满足条件，则尝试调用其 <see cref="Define.Init(XElement)"/> 方法进行初始化。
+        /// 如果初始化失败，则使用默认初始化方法 (<see cref="DefaultInitDefine(Define, XElement, Type)"/>)。
+        /// </remarks>
+        public static Define LoadDefineClass(XElement defineDoc,string className)
         {
             var assembly = Assembly.GetExecutingAssembly();
 
@@ -210,7 +225,22 @@ namespace Data
 
             return define;
         }
-
+        /// <summary>
+        /// 初始化指定的 <paramref name="define"/> 对象，根据 <paramref name="defineDoc"/> 中的 XML 元素内容，
+        /// 将对应的字段值赋给 <paramref name="define"/> 对象。
+        /// </summary>
+        /// <param name="define">需要初始化的对象实例。</param>
+        /// <param name="defineDoc">包含字段定义的 XML 元素 (<see cref="XElement"/>)。</param>
+        /// <param name="defineType">目标对象的类型 (<see cref="Type"/>)。</param>
+        /// <exception cref="ArgumentNullException">
+        /// 如果 <paramref name="define"/>、<paramref name="defineDoc"/> 或 <paramref name="defineType"/> 为 null，则抛出此异常。
+        /// </exception>
+        /// <remarks>
+        /// 该方法会遍历 <paramref name="defineType"/> 的所有字段（包括公共和非公共字段），
+        /// 并尝试从 <paramref name="defineDoc"/> 中找到与字段名称匹配的子元素。
+        /// 如果找到匹配的子元素，则将其值转换为字段的类型并赋值给字段。
+        /// 如果字段类型继承自 <see cref="Define"/>，则递归调用 <see cref="LoadDefineClass(XElement, string)"/> 方法进行加载。
+        /// </remarks>
         public static void DefaultInitDefine(Define define,XElement defineDoc,Type defineType)
         {
             var fields = defineType.GetFields(BindingFlags.Public | BindingFlags.Instance | BindingFlags.NonPublic);
@@ -225,7 +255,17 @@ namespace Data
                     {
                         Object value;
                         if (IsFieldTypeInheritedFrom(field, typeof(Define)))
-                            value = LoadDefineClass(element, field.FieldType.Name);
+                        {
+                            if (element.HasElements)
+                            {
+                                value = LoadDefineClass(element, field.FieldType.Name);
+                            }
+                            else
+                            {
+                                value = new DefineReference(field.FieldType.Name, element.Value, field.Name);
+                                
+                            }
+                        }
                         else
                             value = Convert.ChangeType(element.Value, field.FieldType);
                         field.SetValue(define, value);
@@ -303,5 +343,23 @@ namespace Data
             // 如果字段的类型直接是基类或其派生类，则返回 true
             return fieldType != baseType && baseType.IsAssignableFrom(fieldType);
         }
+        
+        /// <summary>
+        /// 检查字段的类型是否继承自指定的类
+        /// </summary>
+        /// <param name="field">字段信息</param>
+        /// <param name="baseType">要检查的基类类型</param>
+        /// <returns>如果字段的类型是基类或其派生类，则返回 true</returns>
+        public static bool IsFieldTypeInheritedFrom(FieldInfo field, Type baseType)
+        {
+            // 获取字段的类型
+            var fieldType = field.FieldType;
+            // 如果字段的类型为 null 或不是基类的派生类，则返回 false
+            if (!baseType.IsAssignableFrom(fieldType))
+                return false;
+
+            // 如果字段的类型直接是基类或其派生类，则返回 true
+            return fieldType != baseType && baseType.IsAssignableFrom(fieldType);
+        }
     }
 }