.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代码

相关推荐
FreeBuf_5 小时前
黄金旋律IAB组织利用暴露的ASP.NET机器密钥实施未授权访问
网络·后端·asp.net
张小洛6 小时前
Spring AOP 是如何生效的(入口源码级解析)?
java·后端·spring
why技术7 小时前
也是出息了,业务代码里面也用上算法了。
java·后端·算法
白仑色9 小时前
完整 Spring Boot + Vue 登录系统
vue.js·spring boot·后端
ZhangApple10 小时前
微信自动化工具:让自己的微信变成智能机器人!
前端·后端
Codebee10 小时前
OneCode 3.0: 注解驱动的Spring生态增强方案
后端·设计模式·架构
bobz96510 小时前
kubevirt virtinformers
后端
LuckyLay10 小时前
Django专家成长路线知识点——AI教你学Django
后端·python·django
Java微观世界10 小时前
征服Java三大特性:封装×继承×多态+this/super高阶指南
后端
Java技术小馆11 小时前
RPC vs RESTful架构选择背后的技术博弈
后端·面试·架构