.NET Core 初次上手Swagger

安装NuGet 程序包=》Swashbuckle.AspNetCore

在  Startup.ConfigureServices  方法里添加注册生成器

  //注册Swagger生成器，定义一个和多个Swagger 文档
  services.AddSwaggerGen(c =>
  {
     c.SwaggerDoc("v1", new Info() { Title = "测试版本", Version = "v1" });

     c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());
     c.CustomSchemaIds(type => type.FullName); // 解决相同类名会报错的问题

     c.IncludeXmlComments(Path.Combine(Directory.GetCurrentDirectory(), "SwaggerDemo.xml")); // 注释要使用的 XML 文档
  });

如果需要使用到在页面显示控制器的一些注释，可选择生成-输出-XML文档文件。

1591可免去一些没有加注释的一些警告。

注释实例：

----

在  Startup.Configure  方法里添加中间件服务

 //启用中间件服务生成Swagger作为JSON终结点
app.UseSwagger();

//启用中间件服务对swagger-ui，指定Swagger JSON终结点
app.UseSwaggerUI(c =>
{
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "DemoAPI V1");
 });

添加完后，可以自己建控制器了。

注意：控制器必须是API标识的控制器。

里面的方法也必须带有HTTP请求协议。

最后执行访问=》/swagger/index.html

学习来自依乐祝大佬的文章=》点击进入超时空传送