还在用 Swagger（丝袜哥）生成接口文档？我推荐你试试它。。。
作者：小鱼儿511
https://blog.csdn.net/dongbeiou/article/details/106771453
JApiDocs是一个无需额外注解、开箱即用的SpringBoot接口文档生成工具。
编写和维护API文档这个事情，对于后端程序员来说，是一件恼人但又不得不做的事情，我们都不喜欢写文档，但除非项目前后端代码都是自己写的，否则API文档将是前后端协作中一个不可或缺的沟通界面。
既然不可避免，那就想办法弄个轮子吧。人生苦短，必须偷懒。
无图无真相，生成文档的效果如下：
相比Swagger要写一堆注解，Spring RestDocs需要写测试用例，才能生成API文档。JApiDocs 具有无痛集成的特点，你只需花几分钟就能知道它怎么用了。
快速开始
要使得JApiDcos正确工作，你写的代码应该是像下面的样子的：
/**
* 用户接口
*/
@RequestMapping("/api/user/")
@RestController
public class UserController {
/**
* 用户列表
* @param listForm
*/
@RequestMapping(path = "list", method = {RequestMethod.GET, RequestMethod.POST} )
public ApiResult> list(UserListForm listForm){
return null;
}
/**
* 保存用户
* @param userForm
*/
@PostMapping(path = "save")
public ApiResult saveUser(@RequestBody UserForm userForm){
return null;
}
}
我们给Controller类和方法加上必要的注释，给接口方法返回相关的对象类型。是的，这样JApiDocs就能解析到相关的接口信息了，就跟我们平时写的代码是差不多的，但要注意，你要通过@param来告诉JApiDocs接口的参数，但在IDE的帮助下，这个工作将是轻松愉悦的：
然后你在任意一个main入口方法执行下面的代码就可以生成文档了：
DocsConfig config = new DocsConfig();
config.setProjectPath("your springboot project path"); // 项目根目录
config.setProjectName("ProjectName"); // 项目名称
config.setApiVersion("V1.0"); // 声明该API的版本
config.setDocsPath("your api docs path"); // 生成API 文档所在目录
config.setAutoGenerate(Boolean.TRUE); // 配置自动生成
Docs.buildHtmlDocs(config); // 执行生成文档
接下来你只管好好写代码，生成Api文档的工作就可以交给JApiDocs了，你不需要再为额外编写和维护文档而烦恼。
功能特性
1、代码即文档
JApiDocs是通过直接解析SpringBoot的源码语法来工作的，所以只要Controller的语法符合一定的代码规范，有合理的注释，就可以直接导出文档。
2、支持导出HTML
便捷的导航和接口查看界面；可本地预览，或者部署到HTTP服务器。推荐部署到服务器，方便前后端展开协作。
3、同步导出客户端Model代码
支持导出Android端的 Java 和iOS端的 Object C Model代码，减少前端程序员的重复编码工作。
4、更多特性
支持接口搜索；支持不同版本和英文文档；自定义扩展等。
简洁的文档
再好用的东西，如果没有文档说明，别人也无从入手。为了让大家尽快上手，JApiDocs准备了一份极简的文档说明，确保你在几分钟就能用上JApiDocs。
花5分钟不到就能认识一个提高工作效率的工具，让你把更多的时间花在更加有价值的事情上，你确认不看一下吗？
“
仓库地址：https://github.com/YeDaxia/JApiDocs
“中文文档：https://japidocs.agilestudio.cn/#/zh-cn/
福利时间
GIFT TIME
一月一度的送书环节又来了
感谢大家一直以来的陪伴与支持
今天给大家赠送10本书
由北京大学出版社赞助
也欢迎大家自行购买
Java并发编程技术体系化讲解，BAT级别高并发项目深度剖析，领略大咖的实战代码设计艺术。
本次送书不需要评论，也不需要转发
采用最公平的抽奖方式。
关注公众号：程序员面试现场
公众号后台回复：送书
即可参与抽奖
往期推荐
想理解Java的IO，不要从操作系统开始说起的都是耍流氓...
阿里开源那个牛哄哄问题排查工具竟然不会用？最佳实践来了！
性能优越的轻量级日志收集工具，微软、亚马逊都在用！
本文由“壹伴编辑器”提供技术支
直面Java第329期：哪个命令可以监控虚拟机各种运行状态信息？
深入并发第013期：拓展synchronized——锁优化
如果你喜欢本文,
请长按二维码，关注 Hollis.
转发至朋友圈，是对我最大的支持。
点个 在看
喜欢是一种感觉
在看是一种支持
↘↘↘