Merge branch 'abp' of https://gitee.com/ccnetcore/Yi into abp

Yi.Abp.Net8/framework/Yi.Framework.AspNetCore/Microsoft/Extensions/DependencyInjection/SwaggerAddExtensions.cs

@@ -1,7 +1,11 @@
-using System.Diagnostics;
+using System.ComponentModel;
+using System.Diagnostics;
+using System.Text;
+using System.Xml.Linq;
 using Microsoft.AspNetCore.Mvc.Controllers;
 using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Options;
+using Microsoft.OpenApi.Any;
 using Microsoft.OpenApi.Models;
 using Swashbuckle.AspNetCore.SwaggerGen;
 using Volo.Abp.AspNetCore.Mvc;
@@ -75,12 +79,59 @@ namespace Yi.Framework.AspNetCore.Microsoft.Extensions.DependencyInjection
                 {
                     [scheme] = new string[0]
                 });
+
+
+                options.SchemaFilter<EnumSchemaFilter>();
             }
         );
 
-
+         
 
             return services;
         }
     }
+
+
+    /// <summary>
+    /// Swagger文档枚举字段显示枚举属性和枚举值,以及枚举描述
+    /// </summary>
+    public class EnumSchemaFilter : ISchemaFilter
+    {
+        /// <summary>
+        /// 实现接口
+        /// </summary>
+        /// <param name="model"></param>
+        /// <param name="context"></param>
+
+        public void Apply(OpenApiSchema model, SchemaFilterContext context)
+        {
+            if (context.Type.IsEnum)
+            {
+                model.Enum.Clear();
+                model.Type = "string";
+                model.Format = null;
+
+            
+                StringBuilder stringBuilder = new StringBuilder();
+                Enum.GetNames(context.Type)
+                    .ToList()
+                    .ForEach(name =>
+                    {
+                        Enum e = (Enum)Enum.Parse(context.Type, name);
+                        var descrptionOrNull = GetEnumDescription(e);
+                        model.Enum.Add(new OpenApiString(name));
+                        stringBuilder.Append($"【枚举：{name}{(descrptionOrNull is null ? string.Empty : $"({descrptionOrNull})")}={Convert.ToInt64(Enum.Parse(context.Type, name))}】<br />");
+                    });
+                model.Description= stringBuilder.ToString();
+            }
+        }
+
+        private static string? GetEnumDescription(Enum value)
+        {
+            var fieldInfo = value.GetType().GetField(value.ToString());
+            var attributes = (DescriptionAttribute[])fieldInfo.GetCustomAttributes(typeof(DescriptionAttribute), false);
+            return attributes.Length > 0 ? attributes[0].Description : null;
+        }
+
+    }
 }