NetCore 配置Swagger的详细代码

Editor

目录

1.添加Nuget

2.添加静态类扩展方法

3.StartUp注册服务，添加中间件
1.添加Nuget
install-package Swashbuckle.AspNetCore -project XXX -version 6.4.0
2.添加静态类扩展方法
2.1.生成项目xml：选中项目 / 右键 / 属性 / 生成 / 输出 / 选中xml文档文件
2.2.system_v1：必须唯一不重复，且【options.SwaggerDoc("system_v1"】必须与【options.SwaggerEndpoint("/swagger/system_v1/】一致，不然会异常【Failed to load API definition; Fetch error: response status is 404 /swagger/system_v1/swagger.json】
///
    /// Swagger 静态类
    ///
    public static class SwaggerExtend
    {
        ///
        /// 添加服务: swagger
        ///
        ///
        ///
        public static void AddCustSwagger(this IServiceCollection services)
        {
            var version = "V1.0";
            var apiName = "XXX系统";
            services.AddSwaggerGen(options =>
            {
                options.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
                options.SwaggerDoc("system_v1", new OpenApiInfo
                {
                    Version = version,
                    Title = $"{apiName} API",
                    Description = $"{apiName} {version} 接口服务"
                });
                //  获取应用程序所在目录
                var basePath = Path.GetDirectoryName(typeof(SwaggerExtend).Assembly.Location);
                var xmlPath = Path.Combine(basePath, "ProjectName.xml");
                //  swagger界面默认只显示 方法&字段 注释，不显示 控制器注释
                //  第二个参数为true， 则是controller的注释
                //options.IncludeXmlComments(xmlPath);
                options.IncludeXmlComments(xmlPath, true);
            });
        }
        ///
        /// 添加中间件: swagger
        ///
        ///
        public static void UseCustSwagger(this IApplicationBuilder app)
        {
            app.UseSwagger();
            app.UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint("/swagger/system_v1/swagger.json", "系统API");
                //  默认路径为：/swagger/index.html
                //  路由前缀 - 设置为空，可直接跳转到swagger页面：/index.html
                //  api测试可设置为空，部署时容易与前端路由冲突
                options.RoutePrefix = string.Empty;
            });
        }
    }
3.StartUp注册服务，添加中间件
public void ConfigureServices(IServiceCollection services)
        {
            services.AddCustSwagger();
        }
        public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
        {
            app.UseCustSwagger();
        }
到此这篇关于NetCore 配置Swagger的的文章就介绍到这了,更多相关NetCore 配置Swagger内容请搜索知鸟论坛以前的文章或继续浏览下面的相关文章希望大家以后多多支持知鸟论坛！

462710480

论坛不能没有像楼主这样的人才啊！我会一直支持知鸟论坛。

米老鼠和蓝精鼠v

既然你诚信诚意的推荐了，那我就勉为其难的看看吧！知鸟论坛不走平凡路。

123456848

楼主，我太崇拜你了！我想我是一天也不能离开知鸟论坛。

123456865

这东西我收了！谢谢楼主！知鸟论坛真好！

普通人物怨

楼主，我太崇拜你了！我想我是一天也不能离开知鸟论坛。

啤酒瓶空了缓

我看不错噢 谢谢楼主！知鸟论坛越来越好！

123456809

这东西我收了！谢谢楼主！知鸟论坛真好！

知足常乐77

楼主，大恩不言谢了！知鸟论坛是最棒的！

音乐之家1

这个帖子不回对不起自己！我想我是一天也不能离开知鸟论坛。