无论是前端还是后端开发,都或多或少地被接口文档折磨过。前端经常抱怨后端给的接口文档与实际情况不一致。后端又觉得编写及维护接口文档会耗费不少精力,经常来不及更新。所以仅仅只通过强制来规范大家是不够的,随着时间推移,版本迭代,接口文档往往很容易就跟不上代码了。发现了痛点就要去找解决方案。这就是Swagger的由来,通过这套规范,你只需要按照它的规范去定义接口及接口相关的信息。再通过Swagger衍生出来的一系列项目和工具,就可以做到生成各种格式的接口文档。那么在.netCore 中如何使用它呢,废话不说,直接上代码。
一、安装Swashbuckle.AspNetCore
在nuget 上直接搜索该安装包,安装到对应项目中即可
二、添加StartUp 中的配置项目
1.在ConfigureServices 中添加以下代码
2.在Configure 中添加以下代码