.NET 拓展Swagger之【版本控制】

上一节

.NET 拓展Swagger之【添加注释】 - 掘金 (juejin.cn)

创建版本枚举

arduino 复制代码
namespace ZhaoXi.WebSiteApi.Utility.SwaggerExt
{
    public enum ApiVersion
    {
        V1,
        V2
    }
}

服务注册

erlang 复制代码
typeof(ApiVersion).GetEnumNames().ToList().ForEach(version =>
    {
        option.SwaggerDoc(version, new OpenApiInfo()
        {
            Title = $"标题",
            Version = version,
            Description = $"版本号为{version}"
        });
    });
csharp 复制代码
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    // app.UseSwaggerUI();

    app.UseSwaggerUI(c =>
    {
        foreach (string version in typeof(ApiVersion).GetEnumNames())
        {
            c.SwaggerEndpoint($"/swagger/{version}/swagger.json", $"第【{version}】版本");
        }
    });
}

测试

为方法绑定版本

在类上添加:[ApiExplorerSettings(IgnoreApi = false,GroupName = nameof(Utility.SwaggerExt.ApiVersion.V1))]

测试

方法封装

将原先的方法抽出,封装到CustomSwaggerExt类中

csharp 复制代码
using Microsoft.OpenApi.Models;
using System.Runtime.CompilerServices;
using System.Security.Cryptography.X509Certificates;

namespace ZhaoXi.WebSiteApi.Utility.SwaggerExt
{
    public static class CustomSwaggerExt
    {
        public static void AddSwaggerExt(this IServiceCollection services)
        {
            #region Swagger的配置

            services.AddEndpointsApiExplorer();
            services.AddSwaggerGen(option =>
            {
                // xml 文档文件绝对路径--读取根据控制器生成的xml文件
                var file = Path.Combine(AppContext.BaseDirectory,
                    "ZhaoXi.WebSiteApi.xml");
                // true: 显示控制器层注释
                option.IncludeXmlComments(file, true);
                // 对actuin的名称进行排序,如果有多个,就可以看到效果
                option.OrderActionsBy(o => o.RelativePath);

                typeof(ApiVersion).GetEnumNames().ToList().ForEach(version =>
                {
                    option.SwaggerDoc(version, new OpenApiInfo()
                    {
                        Title = $"标题",
                        Version = version,
                        Description = $"版本号为{version}"
                    });
                });

            });
            #endregion
        }


        public static void UseSwaggerExt(this WebApplication app)
        {
           
            if (app.Environment.IsDevelopment())
            {
                app.UseSwagger();
                app.UseSwaggerUI(c =>
                {
                    foreach (string version in typeof(ApiVersion).GetEnumNames())
                    {
                        c.SwaggerEndpoint($"/swagger/{version}/swagger.json", $"第【{version}】版本");
                    }
                });
            }
          
        }
    }
}

替换Program.cs代码

相关推荐
每天进步一点_JL9 分钟前
JVM 类加载:双亲委派机制
java·后端
用户2986985301442 分钟前
Java HTML 转 Word 完整指南
java·后端
J2K1 小时前
JDK都25了,你还没用过ZGC?那真得补补课了
java·jvm·后端
EMQX1 小时前
ESP32 + MCP over MQTT:通过大模型控制智能硬件设备
后端·mcp
郭京京1 小时前
go框架gin(中)
后端·go
郭京京1 小时前
go框架gin(下)
后端·go
林树的编程频道1 小时前
单例模式的推导
后端
就是帅我不改1 小时前
揭秘Netty高性能HTTP客户端:NIO编程的艺术与实践
后端·面试·github
Ray661 小时前
SugLucene索引构建
后端
舒一笑2 小时前
Saga分布式事务框架执行逻辑
后端·程序员·设计