smart-doc 是一个 java restful api 文档生成工具,smart-doc 完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要写上 java 的标准注释,smart-doc 就能帮你生成一个简易明了的 Markdown、Html、AsciiDoc 文档和 Postman json 一键导入的测试数据。如果你不喜欢其他工具强侵入的注解污染,smart-doc 给你一个不错的选择!喜欢 smart-doc 的用户也不要忘记给项目 star,你们的支持是 smart-doc 持续推进的动力。
响应用户需求,对 spring 的表单参数绑定做了全面的支持,smart-doc 不再是仅仅支持 json 参数。
合并 fork 分支的 github book html5 模板,新增搜索和锚点。
新增自定义 @mock tag 用于指定生成文档时的默认字段值,@param 的参数注释增加 mock 值的解析功能(@param name 姓名|张三), 此项改进可以满足用户直接使用 smart-doc 生成交付给第三方公司的对接文档。
smart-doc-maven-plugin 插件增强对 maven 标准项目的支持(插件仍然存在一些问题,当前未找到解决办法)。
对生成的 postman json 数据做了全面的增强,无论是 json 还是表单参数,导出的 postman json 可以一键导入 postman 自动完成参数列表回填。
优化对实体类中枚举字段的支持。
增加对实体中静态常量常量字段的过滤。
本次主要是对表单参数和 postman 数据导出做了增强。也修改了一起 bug 和部分源码做了重构,建议用户升级到最新。
排名不分先后
这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。
V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。
V2EX is a community of developers, designers and creative people.