.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

 

 

 

 

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