栗山帆花,冬尼卡盟,中餐座次礼仪
随着互联网技术的发展，现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，而且前端技术和后端技术在各自的道路上越走越远。
前端和后端的唯一联系，变成了api接口；api文档变成了前后端开发人员联系的纽带，变得越来越重要，swagger就是一款让你更好的书写api文档的框架。
没有api文档工具之前，大家都是手写api文档的，在什么地方书写的都有，有在confluence上写的，有在对应的项目目录下readme.md上写的，每个公司都有每个公司的玩法，无所谓好坏。
书写api文档的工具有很多，但是能称之为“框架”的，估计也只有swagger了。
在此先介绍一款其他的api文档工具，叫，这玩意儿用一句话就能概括：解放生产力，代替手写api的web工具。
rap写起来确实比手写文档要快， 可以选择某个项目，写针对某个项目的api
rap是由阿里开发的，整个阿里都在用，还不错。github地址为：https://github.com/thx/rap
当然咯，rap不可能只有线上版本，肯定可以部署到私服上。
https://github.com/thx/rap/wiki/deploy_manual_cn
rap挺好的，但是和swagger比起来有点轻量。
先看看swagger的生态使用图：
其中，红颜色的是swaggger官网方推荐的。
下面再细看看swagger的生态的具体内容：
这玩意儿从名字就能看出来，用来显示api文档的。和rap不同的是，它不可以编辑。
就是一个在线编辑文档说明文件（swagger.json或swagger.yaml文件）的工具，以方便生态中的其他小工具（swagger-ui）等使用。
左边编辑，右边立马就显示出编辑内容来。
编辑swagger说明文件使用的是yaml语法具体的内容可以去官网查看。
目前最流行的做法，就是在代码注释中写上swagger相关的注释，然后，利用小工具生成swagger.json或者swagger.yaml文件。
目前官方没有推出。github上各种语言各种框架各种有，可以自己搜吧搜吧，这里只说一个php相关的。 swagger-php :
这个小工具是用来校验生成的文档说明文件是否符合语法规定的。用法非常简单，只需url地址栏，根路径下加上一个参数url，参数内容是放swagger说明文件的地址。即可校验。
docker hub地址为：
可以pull下镜像来自己玩玩。
代码生成器，脚手架。可以根据swagger.json或者swagger.yml文件生成指定的计算机语言指定框架的代码。
有一定用处，java系用的挺多。工业上应该不咋用。
这个目前还没有找到很合适的mock工具，包括rap也好，其他api文档工具也好，都做的不够完善，大多就是根据说明文件，例如swagger.json等生成一些死的静态的mock数据，不能够根据限定条件：例如“只能是数字，必传”等做出合理的回应。
1、安装包 swashbuckle
会自动生成 swaggerconfig.cs文件
2、右键项目属性—>生成—>勾选xml文档文件
eg bin\webapi.xml 【若对api写了注释，并在swagger中 开启了，则会自动生成一些说明节点】
3、运行 eg：http://localhost:2146/swagger
4、发现，安装完成后，写注释并没有在swagger页面上面增加，所以我们现在开开启注释
在swaggerconfig类中，enableswagger的时候添加下面xml解析（默认是有的，只是注释掉了）
c.includexmlcomments(getxmlcommentspath());
并添加方法 即可
我要评论
/// <summary>
/// 添加xml解析
/// </summary>
/// <returns></returns>
private static string getxmlcommentspath()
{
return string.format("{0}/bin/webapi.xml", system.appdomain.currentdomain.basedirectory);
}
xml文档中也会自动写入注释
5、调试
注意参数是字符串时需要带双引号""，、
更多参考：
如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复
Blazor server side 自家的一些开源的, 实用型项目的进度之 CEF客户端
.NET IoC模式依赖反转(DIP)、控制反转(Ioc)、依赖注入(DI)
vue+.netcore可支持业务代码扩展的开发框架 VOL.Vue 2.0版本发布
网友评论