smart-doc 1.8.0 发布 Java 零侵入 API 文档生成工具

2020-01-04 13:56:49 +08:00
 smartdoc647

smart-doc 是一个 java restful api 文档生成工具,smart-doc 完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要写上 java 的标准注释,smart-doc 就能帮你生成一个简易明了的 Markdown、Html、AsciiDoc 文档和 Postman json 一键导入的测试数据。如果你不喜欢其他工具强侵入的注解污染,smart-doc 给你一个不错的选择!喜欢 smart-doc 的用户也不要忘记给项目 star,你们的支持是 smart-doc 持续推进的动力。

功能特性

项目仓库

smart-doc 的码云仓库链接

github 仓库地址链接

更新内容

  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. 增加对实体中静态常量常量字段的过滤。

升级建议

本次主要是对表单参数和 postman 数据导出做了增强。也修改了一起 bug 和部分源码做了重构,建议用户升级到最新。

DEMO

使用 demo 轻松玩转接口文档生成

相关文档

smart-doc 文档 wiki

smart-doc 的部分用户

排名不分先后

1849 次点击
所在节点    程序员
4 条回复
codepm
2020-01-04 20:49:09 +08:00
产品《项目加》也来支持下。
cydian
2020-01-05 01:49:16 +08:00
额。你的用户列表??
hccsoul
2020-01-05 15:04:34 +08:00
识别不了自定义的 dao,提示 Error 找不到符号
kylix
2020-01-05 19:22:00 +08:00
有机会就试用一下看看

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/635008

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX