webApi集成swagger

通过上篇博客,我们已经成功的让webapi返回了json串,但是对于一个webapi来说,一个可视化的界面还有调试工具是不可少的,所以今天,来给webapi添加swagger。

添加swagger包

右键项目,然后点击 管理NuGet包

然后选择浏览,搜索swagger,安装以下两个包

安装好后,我们会发现,在我们的项目中多了很多东西

为swagger生成xml文件

打开解决方案属性-->生成,勾选XML文档文件,保存

记住这个XML文件的名字

然后打开App_Start文件夹下的SwaggerConfig文件

将v1后面引号里改成刚才记住的文件名,继续往下找,去掉这句话的注释,然后复制括号里面的方法

完成刚才复制的方法,注意写自己记住的xml文件名

打开swggernet文件,修改下图的代码,确保文件名是自己的那个

打开swggernet文件,注释掉下面的两行代码

在自己的路径下添加    /swagger/ui/index

例如  localhost:14173/swagger/ui/index

即可以打开swagger界面了