这篇想写一个工具。Nswag,这个工具能够让接口数据可视化,也可以生产API文档,同时可以生成客户端代码,进行测试。
不过我目前在学习阶段,觉得该工具好用的地方是接口可视化,非常的直观和明了,其他的功能我还没有用到。
我参考了网上的工具安装方法,自己也尝试了一下。
本次使用的是VS2019+ASP.NET CORE 3.0
1.安装nuget包NSwag.AspNetCore (创建项目的过程就直接跳过了)
PS:如果有小伙伴搜Nuget搜不出来,请查看Nuget设置。如下图,可以根据箭头所示加号自己添加一个程序包源,名称和源安装如下所示。
2.接下来,在Startup.cs文件中配置Nswag服务和中间件。
在Configure中加入中间件。
3.配置项目 用于生成XML文件 我现在还没怎么用到 现在当做记录一下
4.改配置文件,将launchBrowser 改成/swagger
5.启动项目看下效果. 默认打开的网址是:http://localhost:5000/swagger/index.html
这个可视化的接口工具看的非常清楚,一目了然。