1.配置Swagger

1.为生成的api追加注释

Program.cs

builder.Services.AddSwaggerGen(option =>
{
    //xml文档绝对路经--读取根据控制器api生成的Xml的文件  ?????
    var file = Path.Combine(AppContext.BaseDirectory,
        "BookReadWebApi.xml");
​
    //true显示器层展示注释
    option.IncludeXmlComments(file, true);
​
    //action排序
    option.OrderActionsBy(o => o.RelativePath);
});

配置让swagger展示注释

2.不同版本api的版本控制

0.创建版本枚举文件夹

1.获取api的名称

builder.Services.AddSwaggerGen(option =>
{
    typeof(ApiVersions).GetEnumNames().ToList().ForEach(Version =>
    {
        //1.先获取所有name
      option.SwaggerDoc(Version,new Microsoft.OpenApi.Models.OpenApiInfo() 
      {
        Title = $"读书平台",
        Version = Version,
        Description = $"通用版本的CoreApi版本{Version}"
      });
    });
    ......
    }

2.遍历api

app.UseSwaggerUI(c =>
{
    foreach(string version in typeof(ApiVersions).GetEnumNames())
    {
        c.SwaggerEndpoint($"/swagger/{version}/swagger.json",$"阅读平台第{version} 版本");
    }
});

3.控制当前api只在特定(V1)的版本中展示改接口

[ApiExplorerSettings(IgnoreApi =false,GroupName =nameof(Utility.SwaggerExt.ApiVersions.V1))]

静态类里面的静态方法的this成为扩展方法

可以将里面的方法调用改写

CustomSwaggerExt.AddSwaggerExt(builder.Services);等效于
builder.Services.AddSwaggerExt();

这就是中间件的封装？？？？？不懂，不管