smart-doc是一个java restful api文档生成工具, smart-doc完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要写上java的标准注释,smart-doc就能帮你生成一个简易明了的Markdown、Html、AsciiDoc文档和Postman json一键导入的测试数据。如果你不喜欢其他工具强侵入的注解污染,smart-doc给你一个不错的选择!喜欢smart-doc的用户也不要忘记给项目star,你们的支持是smart-doc持续推进的动力。
Smart-doc vs Swagger
1. 响应用户需求,对spring的表单参数绑定做了全面的支持,smart-doc不再是仅仅支持json参数。
2. 合并fork分支的github book html5模板,新增搜索和锚点。
3. 新增自定义@mock tag用于指定生成文档时的默认字段值,@param 的参数注释增加mock值的解析功能(@param name 姓名|张三),
此项改进可以满足用户直接使用smart-doc生成交付给第三方公司的对接文档。
4. smart-doc-maven-plugin插件增强对maven标准项目的支持(插件仍然存在一些问题,当前未找到解决办法)。
5. 对生成的postman json数据做了全面的增强,无论是json还是表单参数,导出的postman json可以一键导入postman自动完成参数列表回填。
6. 优化对实体类中枚举字段的支持。
7. 增加对实体中静态常量常量字段的过滤。
从smart-doc 1.7.9版本开始。我们提供了smart-doc的插件smart-doc-maven-plugin,目前该插件只做试用。
插件使用文档
本次主要是对表单参数和postman数据导出做了增强。也修改了一起bug和部分源码做了重构,建议用户升级到最新。
使用demo 轻松玩转接口文档生成
smart-doc文档wiki