feat:文档枚举注释添加

sunpengfei

2025-08-01 a01fa150d1652e32064cf155cb3317618961e230

 FlexJobApi.Core/Utils/SwaggerUtils/EnumSchemaFilter.cs

@@ -18,23 +18,8 @@
            if (context.Type.IsEnum)
            {
                // 枚举类型的描述（来自枚举本身的注释）
                schema.Description ??= GetEnumDescription(context.Type);
                schema.Description = EnumUtils.GetModel(context.Type).Result.ToJson();
            }
        }

        // 获取枚举类型的注释
        private string GetEnumDescription(Type enumType)
        {
            var xmlDoc = XmlDocUtils.GetXmlDocAsync().Result;
            var member = XmlDocUtils.GetXmlDocMemberAsync(enumType, xmlDoc).Result;
            var description = member?.Summary ?? "";
            foreach (var enumValue in Enum.GetValues(enumType))
            {
                var enumMember = enumType.GetMember(enumValue.ToString()).First();
                var enumXmlDocMember = XmlDocUtils.GetXmlDocMemberAsync(enumMember, xmlDoc).Result;
                description += $"{enumValue}-{enumXmlDocMember?.Summary} ";
            }
            return description;
        }
    }
}