dotnet webapi 中添加Swagger文档

首先添加"SwaggerGenerator": "1.1.0","SwaggerUi": "1.1.0" 需要注意的是这两个组件是我对Swashbuckle的重新封装，因为当前版本对泛型会报错。

在ConfigureServices 中添加：

 services.ConfigureSwaggerGen(options =>
             {

                 options.SwaggerDoc("v1",
                   new Info
                   {
                       Version = "v1",
                       Title = "ryan API",
                   }
               );
                 options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, Assembly.GetEntryAssembly().GetName().Name+".xml"));
                 options.IncludeXmlComments(Path.Combine(AppContext.BaseDirectory, Assembly.GetEntryAssembly().GetName().Name + ".Application.xml"));
                 options.DescribeAllEnumsAsStrings();
             });

在config方法中添加：

  if (HostingEnvironment.IsDevelopment())
             {
                 app.UseSwagger();
                 app.UseSwaggerUi(c=>c.SwaggerEndpoint("/swagger/v1/swagger.json", "V1 Docs"));
             }

在controller中需要添加attribute,否则文档会生成失败。

齐活，在浏览取中输入 http:{youhost}/swagger   即可访问了。