如何通过Asp.net core WebApi结合Swagger快速生成详尽的API帮助文档？
- 内容介绍
- 文章标签
- 相关推荐
本文共计522个文字，预计阅读时间需要3分钟。
最近我们团队一直在进行.net core的转型，朝着前后端分离的技术架构迈进。我们后台主要采用了asp.net core webapi进行开发，每次调试以及与前端人员沟通都存在效率低下的情况。
最近我们团队一直进行.net core的转型，web开发向着前后端分离的技术架构演进，我们后台主要是采用了asp.net core webapi来进行开发，开始每次调试以及与前端人员的沟通上都存在这效率低下的问题，一次在看微软asp.net core官方文档的时候，发现了swagger这个好东西。然后在实际的项目中引入了该技术。我们开发人员测试自己写的api的过程大大得到了简化，前端人员也可以根据我们提供的swagger help pages 自己进行一些前端代码的测试，大大提高了前后端的开发效率。下面我就拿我自己的真实上线项目来一步一步的讲解如何在asp.net core webapi中引入swagger。(也可以参照微软官方文档：docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger)
一、引入swagger Nuget包
右键点击wepapi项目的依赖项，点击管理Nuget程序包，如下图：
在打开的NuGet包程序管理界面，输入：Swashbuckle.AspNetCore 目前该程序包的版本为1.0.0，点击安装。
安装完后，需要在项目中的Startup.cs文件中进行配置。
二、配置Swagger
打开Startup.cs 文件，在ConfigureServices 方法中，添加如下代码：
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Info
{
Version = "v1",
Title = "TwBusManagement接口文档",
Description = "RESTful API for TwBusManagement",
TermsOfService = "None",
Contact = new Contact { Name = "Alvin_Su", Email = "asdasdasd@outlook.com", Url = "" }
});
//Set the comments path for the swagger json and ui.
var basePath = PlatformServices.Default.Application.ApplicationBasePath;
var xmlPath = Path.Combine(basePath, "twbusapi.xml");
c.IncludeXmlComments(xmlPath);
// c.OperationFilter<HttpHeaderOperation>(); // 添加github.com/domaindrivendev/Swashbuckle.AspNetCore 以及微软文档：docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持易盾网络。
本文共计522个文字，预计阅读时间需要3分钟。
最近我们团队一直在进行.net core的转型，朝着前后端分离的技术架构迈进。我们后台主要采用了asp.net core webapi进行开发，每次调试以及与前端人员沟通都存在效率低下的情况。
最近我们团队一直进行.net core的转型，web开发向着前后端分离的技术架构演进，我们后台主要是采用了asp.net core webapi来进行开发，开始每次调试以及与前端人员的沟通上都存在这效率低下的问题，一次在看微软asp.net core官方文档的时候，发现了swagger这个好东西。然后在实际的项目中引入了该技术。我们开发人员测试自己写的api的过程大大得到了简化，前端人员也可以根据我们提供的swagger help pages 自己进行一些前端代码的测试，大大提高了前后端的开发效率。下面我就拿我自己的真实上线项目来一步一步的讲解如何在asp.net core webapi中引入swagger。(也可以参照微软官方文档：docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger)
一、引入swagger Nuget包
右键点击wepapi项目的依赖项，点击管理Nuget程序包，如下图：
在打开的NuGet包程序管理界面，输入：Swashbuckle.AspNetCore 目前该程序包的版本为1.0.0，点击安装。
安装完后，需要在项目中的Startup.cs文件中进行配置。
二、配置Swagger
打开Startup.cs 文件，在ConfigureServices 方法中，添加如下代码：
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Info
{
Version = "v1",
Title = "TwBusManagement接口文档",
Description = "RESTful API for TwBusManagement",
TermsOfService = "None",
Contact = new Contact { Name = "Alvin_Su", Email = "asdasdasd@outlook.com", Url = "" }
});
//Set the comments path for the swagger json and ui.
var basePath = PlatformServices.Default.Application.ApplicationBasePath;
var xmlPath = Path.Combine(basePath, "twbusapi.xml");
c.IncludeXmlComments(xmlPath);
// c.OperationFilter<HttpHeaderOperation>(); // 添加github.com/domaindrivendev/Swashbuckle.AspNetCore 以及微软文档：docs.microsoft.com/zh-cn/aspnet/core/tutorials/web-api-help-pages-using-swagger
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持易盾网络。