netcore2.2以及netcore3.0下的swagger使用

自从core3.0发布后，中间有很多东西跟以往用到的2.2版本相差特别多，今天主要来说一下swagger不同版本下的使用。

swagger就是一个可视化接口工具，为了方便让调用者能够很好的了解接口以及接口需要的参数！具体界面不做过多的截图，今天主要以应用为主。

一：2.2版本下面使用swagger

1.1：创建一个netcore2.2版本的webapi的项目

1.2：在Nuget中添加Swashbuckle.AspNetCore

1.3：在Startup类中增加如下内容：

     1.3.1：在ConfigureServices方法中增加：services.AddSwaggerGen，具体代码如下：

 1  #region 注册Swagger生成器
 2             services.AddSwaggerGen(c =>
 3             {
 4                 c.SwaggerDoc("v1", new Info
 5                 {
 6                     Version = "v1.0",
 7                     Title = "wss API",
 8                     Contact = new Contact
 9                     {
10                         Name = "wss",
11                         Email = "loverwangshan@qq.com",
12                         Url = "331803047"
13                     },
14                     License = new License
15                     {
16                         Name = "版权所有 © wss",
17                         Url = "http://331803047"
18                     }
19                 });
20                 var path = Path.Combine(AppContext.BaseDirectory, "MyFramework4CoreTest.xml");  //MyFramework4CoreTest.xml为右键属性生成的xml文件
21                 c.IncludeXmlComments(path);
22                 //c.OperationFilter<AddAuthTokenHeaderParameter>();
23             });
24   #endregion

     1.3.2：Configure方法中增加：app.UseSwagger跟app.UseSwaggerUI，具体如下：

#region Swagger
            // 启用中间件服务生成Swagger作为JSON终结点
            app.UseSwagger();
            // 启用中间件服务对swagger-ui，指定Swagger JSON终结点
            app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("/swagger/v1/swagger.json", "create by wss");
            });
 #endregion

View Code