向net core 3.0进击——Swagger的改变

[toc]

前言

十一小长假在不知不觉间可都没了，在这个小尾巴的空隙，把这两天鼓捣的net core 3.0升级过程记录一下，首先仍是根据以前的顺序一个个补充进来，先从Swagger的变化提及（新建工程什么的很少说了，就是选择的时候选3.0就能够了，2019新版更新后建立默认都是3.0）。

引入

按以前的习惯，对于引入我是不会多说，一个连接（我本身以前引入那些截图）就给你们了，可是由于3.0属于比较新的版本，因此在引入的时候，有些注意点仍是要标注下的。

在3.0中，咱们会在Startup这里发现，Mvc没了统一替换成Controllers，固然这并不影响咱们使用，可是最关键的，咱们用来实验的Values木得了，取而代之的是一个挺不错的api的WeatherForecast接口

引入以后，咱们还复制咱们以前的swagger配置内容来试试，会发现新版也针对类名，属性作了雪微的调整，这里直接一张图就能够看到。

#region Swagger
            services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new OpenApiInfo
                {
                    Version = "v1.1.0",
                    Title = "ERP WebAPI",
                    Description = "后台框架",
                    Contact = new OpenApiContact() { Name = "Blank", Email = "1829027193@qq.com", Url = new Uri("https://www.cnblogs.com/AprilBlank/") }
                });
            });
            #endregion

在使用注册引用的地方却是没有变化。

#region Swagger
            app.UseSwagger();
            app.UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint("/swagger/v1/swagger.json", "ApiHelp V1");
                //若是设置根目录为swagger,将此值置空
                options.RoutePrefix = string.Empty;
            });
            #endregion

注释此次也一步到位，固然也是没有太大的区别的。 首先，咱们来生成xml文件。

而后，咱们直接复制以前的配置内容便可。

#region Swagger
            services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new OpenApiInfo
                {
                    Version = "v1.1.0",
                    Title = "ERP WebAPI",
                    Description = "后台框架",
                    Contact = new OpenApiContact() { Name = "Blank", Email = "1829027193@qq.com", Url = new Uri("https://www.cnblogs.com/AprilBlank/") }
                });
                // 为 Swagger JSON and UI设置xml文档注释路径
                var basePath = Path.GetDirectoryName(AppContext.BaseDirectory);//获取应用程序所在目录（绝对，不受工做目录影响，建议采用此方法获取路径）
                var xmlPath = Path.Combine(basePath, "ERP.Api.xml");
                options.IncludeXmlComments(xmlPath);
            });
            #endregion

全搞完以后，咱们把默认路径直接指向根路径。

测试

唉，没有Values之后测试可怎么过啊。

ok，咱们来给默认建立的控制器写个注释。

全部整理完毕以后，咱们直接运行程序，这时就会发现，新版的swagger对于默认界面也是作了些调整的。

小结

net core 3.0做为一个期待已久的版本，大统一的前景仍是挺不错的，编程语言只是一个工具，没有好坏之分，因此无需纠结，你为什么而编程，相信每一个人心中都已有答案。

原文出处：https://www.cnblogs.com/AprilBlank/p/11633522.html