feat:枚举注释优化

sunpengfei

2025-08-01 5a657f2ef43afc5a2a284e7b75d7db91e534c020

feat:枚举注释优化

 FlexJobApi.Core/FlexJobApi.Core.xml

@@ -2218,6 +2218,18 @@
            描述
            </summary>
        </member>
        <member name="T:FlexJobApi.Core.EnumUtils">
            <summary>
            枚举工具
            </summary>
        </member>
        <member name="M:FlexJobApi.Core.EnumUtils.GetModel(System.Type)">
            <summary>
            获取模型
            </summary>
            <param name="type"></param>
            <returns></returns>
        </member>
        <member name="T:FlexJobApi.Core.EventBusServiceComponent">
            <summary>
            事件总线

 FlexJobApi.Core/Utils/EnumUtils/EnumUtils.cs

@@ -6,8 +6,16 @@

namespace FlexJobApi.Core
{
    /// <summary>
    /// 枚举工具
    /// </summary>
    public static class EnumUtils
    {
        /// <summary>
        /// 获取模型
        /// </summary>
        /// <param name="type"></param>
        /// <returns></returns>
        public static async Task<EnumModel> GetModel(this Type type)
        {
            var model = new EnumModel();

 FlexJobApi.Core/Utils/SwaggerUtils/EnumSchemaFilter.cs

@@ -18,7 +18,11 @@
            if (context.Type.IsEnum)
            {
                // 枚举类型的描述（来自枚举本身的注释）
                schema.Description = EnumUtils.GetModel(context.Type).Result.ToJson();
                var model = EnumUtils.GetModel(context.Type).Result;
                var items = model.Items
                    .Select(it => $"{it.Name ?? it.Value.ToString()}-{it.Value}-{it.Description ?? "没写注释"}")
                    .SplitJoin(",");
                schema.Description = $"{model.Description ?? "没写注释"}|{items}";
            }
        }
    }