.Net Core3.1下使用Swagger搭建web api项目

2021-01-14 23:12

阅读:422

标签:显示   err   tab   efault   com   url   sdk   inf   做了   

先下载.net core 3.1的SDK(开发.net core项目时会用到)和Runtime(用来运行.net core的应用程序)

地址:https://dotnet.microsoft.com/download/visual-studio-sdks?utm_source=getdotnetsdk&utm_medium=referral

这里说一下项目目录下的各个文件的作用

技术图片

 

 

 引入Swashbuckle.AspNetCore程序包

 

技术图片

 

 

 执行以下命令

Install-Package Swashbuckle.AspNetCore -Version 5.0.0-rc4

  

技术图片

 

 

 

添加 并配置Swagger中间件
services.AddSwaggerGen(c =>
  {
      c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
  });

  

技术图片

 

 

 

app.UseSwagger();
  app.UseSwaggerUI(c =>
  {
      c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
  });

  

技术图片

 

 

 现在添加一个控制器,写一个接口看看能不能出来

技术图片

 

 

 地址栏改一下

swagger/index.html

技术图片

 

 

 

如果对接口做了xml注释,要在Startup添加如下代码,才可以显示出来

先引入NuGet包:Microsoft.Extensions.PlatformAbstractions

然后右键属性

技术图片

 

 

 

再在Startup中添加下面的代码

 var basePath = PlatformServices.Default.Application.ApplicationBasePath;
 //Core.Admin.webapi.xml是我的项目生成XML文档的后缀名,具体的以你项目为主
 var xmlPath = Path.Combine(basePath, "Core.Admin.webapi.xml");
 c.IncludeXmlComments(xmlPath);

技术图片

 

 

 运行项目,注释已经出来了

技术图片

 

 

 在launchSettings.json中更改一下launchUrl这个环境变量,这样就不用每次都改地址栏了

技术图片

 

 

最后附上微软官方教程地址

https://docs.microsoft.com/zh-cn/aspnet/core/tutorials/getting-started-with-swashbuckle?view=aspnetcore-3.1&tabs=visual-studio


.Net Core3.1下使用Swagger搭建web api项目

标签:显示   err   tab   efault   com   url   sdk   inf   做了   

原文地址:https://www.cnblogs.com/shenghuotaiai/p/12248613.html


评论


亲,登录后才可以留言!