.NET Core Swagger 的分组使, 以及相同Action能被多个分组公用,同时加载出尚未分组的数据出来

 /// <summary>     /// 系统分组特性     /// </summary>     public class ApiGroupAttribute : Attribute     {         public ApiGroupAttribute(params ApiGroupNames[] name)         {             GroupName = name;         }         public ApiGroupNames[] GroupName { get; set; }     }

/// <summary>     /// 系统分组枚举值     /// </summary>     public enum ApiGroupNames     {         [GroupInfo(Title = "All", Description = "All接口", Version = "")]         All = 0,         [GroupInfo(Title = "尚未分组", Description = "尚未分组相关接口", Version = "")]         NoGroup = 1,         [GroupInfo(Title = "登录认证", Description = "登录认证相关接口", Version = "")]         Login = 2,         [GroupInfo(Title = "IT", Description = "登录认证相关接口", Version = "")]         It = 3,         [GroupInfo(Title = "人力资源", Description = "登录认证相关接口", Version = "")]         Hr = 4,         [GroupInfo(Title = "系统配置", Description = "系统配置相关接口", Version = "")]         Config = 5     }

public class GroupInfoAttribute : Attribute     {         public string Title { get; set; }         public string Version { get; set; }         public string Description { get; set; }     } 

#region swagger              var openApiInfo = new OpenApiInfo             {                 Version = "v1",                 Title = "WebApi",                 Description = "A simple example ASP.NET Core Web API",                 TermsOfService = new Uri("https://www.cnblogs.com/goodluckily/"),                 Contact = new OpenApiContact                 {                     Name = "雨太阳",                     Email = string.Empty,                     Url = new Uri("https://www.cnblogs.com/goodluckily/")                 },                 License = new OpenApiLicense                 {                     Name = "许可证名字",                     Url = new Uri("https://www.cnblogs.com/goodluckily/")                 }             };              services.AddSwaggerGen(c =>             {                 #region 分组方案二                  //遍历ApiGroupNames所有枚举值生成接口文档，Skip(1)是因为Enum第一个FieldInfo是内置的一个Int值                 typeof(ApiGroupNames).GetFields().Skip(1).ToList().ForEach(f =>                 {                     //获取枚举值上的特性                     var info = f.GetCustomAttributes(typeof(GroupInfoAttribute), false).OfType<GroupInfoAttribute>().FirstOrDefault();                     openApiInfo.Title = info?.Title;                     openApiInfo.Version = info?.Version;                     openApiInfo.Description = info?.Description;                     c.SwaggerDoc(f.Name, openApiInfo);                 });                  //判断接口归于哪个分组                 c.DocInclusionPredicate((docName, apiDescription) =>                 {                     if (!apiDescription.TryGetMethodInfo(out MethodInfo method)) return false;                     //1.全部接口                     if (docName == "All") return true;                     //反射拿到控制器分组特性下的值                     var actionlist = apiDescription.ActionDescriptor.EndpointMetadata.FirstOrDefault(x => x is ApiGroupAttribute);                     //2.得到尚未分组的接口***************                     if (docName == "NoGroup") return actionlist == null ? true : false;                     //3.加载对应已经分好组的接口                     if (actionlist != null)                     {                         //判断是否包含这个分组                         var actionfilter = actionlist as ApiGroupAttribute;                         return actionfilter.GroupName.Any(x => x.ToString().Trim() == docName);                     }                     return false;                 });                  #endregion                  //添加授权                  //认证方式，此方式为全局添加                   var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";                 var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);                 c.IncludeXmlComments(xmlPath, true);             }); #endregion 

 #region Swagger              app.UseSwagger();             app.UseSwaggerUI(c =>             {                 c.RoutePrefix = "swagger";                  #region 分组方案二                 //遍历ApiGroupNames所有枚举值生成接口文档，Skip(1)是因为Enum第一个FieldInfo是内置的一个Int值                 typeof(ApiGroupNames).GetFields().Skip(1).ToList().ForEach(f =>                 {                     //获取枚举值上的特性                     var info = f.GetCustomAttributes(typeof(GroupInfoAttribute), false).OfType<GroupInfoAttribute>().FirstOrDefault();                     c.SwaggerEndpoint($"/swagger/{f.Name}/swagger.json", info != null ? info.Title : f.Name);                 });                 #endregion                  //swagger 默认折叠                 //c.DocExpansion(Swashbuckle.AspNetCore.SwaggerUI.DocExpansion.None);                  //MiniProfiler用的                 c.IndexStream = () => GetType().GetTypeInfo().Assembly.GetManifestResourceStream("WebApi.index.html");             });  #endregion

    [ApiController]     [Route("[controller]")]     public class WeatherForecastController : Controller     {          private readonly ILogger<WeatherForecastController> _logger;          private readonly IHttpContextAccessor _accessor;         public WeatherForecastController(ILogger<WeatherForecastController> logger, IHttpContextAccessor accessor)         {             _logger = logger;             _accessor = accessor;         }         /// <summary>         /// 多分组共用请求         /// </summary>         /// <returns></returns>         //[ProducesResponseType(201)]         //[ProducesResponseType(400)]          [HttpGet("getLoginAndIT")]         [ApiGroup(ApiGroupNames.Login,ApiGroupNames.It)]         public IActionResult GetLoginAndIT()         {             return  Json("GetLoginAndIT ok");         }          [HttpGet("getConfig")]         [ApiGroup(ApiGroupNames.Config)]         public IActionResult GetConfig()         {             return Json("Config ok");         }           [HttpGet("getHr")]         [ApiGroup(ApiGroupNames.Hr)]          public IActionResult GetHr()         {             return Json("Hr ok");         }          [HttpGet("getIt")]         [ApiGroup(ApiGroupNames.It)]          public IActionResult GetIt()         {             return Json("GetIt ok");         }         /// <summary>         /// 获取Miniprofiler Index的 Script (尚未分组的)         /// </summary>         /// <returns></returns>         [HttpGet("getMiniprofilerScript")]         public IActionResult getMiniprofilerScript()         {             var htmlstr = MiniProfiler.Current.RenderIncludes(_accessor.HttpContext);             var script = htmlstr.Value;             return Json(script);         }     }