smart-doc 是一款同时支持 JAVA REST API 和 Apache Dubbo RPC 接口文档生成的工具,smart-doc 利用接口泛型和 javadoc 注释自动分析生成 api 接口文档,不采用任何注解侵入到业务代码中。只需要在项目中引入 smart-doc 提供的 maven 或者是 gradle 插件,然后按照规范写好 javadoc 注释即可生成 api 文档。同时 smart-doc 也支持生成 openapi 和 postman 这些规范的文档,生成后可以直接导入相关工具做测试。
目前在国内已被小米、科大讯飞、同程旅行、快手、马蜂窝、顺丰等知名公司所使用。
https://github.com/TongchengOpenSource/smart-doc
@javadoc
@order
本次版本迭代后经过测试,在Springboot 3.0.0+版本的框架下,smart-doc的OpenAPI生成能力甚至优于springdoc-openapi,在测试中发现OpenAPI UI对于一些接口生成的结构定义存在bug。
本次更新新增 2 位新的社区贡献者,非常感谢上面的两位贡献者积极的参与社区贡献。为社区的发展起到了非常积极的作用。
评论删除后,数据将无法恢复
smart-doc 3.0.5 发布,Java 零注解 API 文档生成工具
smart-doc 是一款同时支持 JAVA REST API 和 Apache Dubbo RPC 接口文档生成的工具,smart-doc 利用接口泛型和 javadoc 注释自动分析生成 api 接口文档,不采用任何注解侵入到业务代码中。只需要在项目中引入 smart-doc 提供的 maven 或者是 gradle 插件,然后按照规范写好 javadoc 注释即可生成 api 文档。同时 smart-doc 也支持生成 openapi 和 postman 这些规范的文档,生成后可以直接导入相关工具做测试。
目前在国内已被小米、科大讯飞、同程旅行、快手、马蜂窝、顺丰等知名公司所使用。
仓库地址
https://github.com/TongchengOpenSource/smart-doc
重要更新内容
@javadoc标签支持普通java类文档的生成(ps: smart-doc生成javadoc文档)@order标签时序列号排序不正确的问题,本次修复后用户可以完全自由设置接口类的order编号本次版本迭代后经过测试,在Springboot 3.0.0+版本的框架下,smart-doc的OpenAPI生成能力甚至优于springdoc-openapi,在测试中发现OpenAPI UI对于一些接口生成的结构定义存在bug。
新增贡献者
本次更新新增 2 位新的社区贡献者,非常感谢上面的两位贡献者积极的参与社区贡献。为社区的发展起到了非常积极的作用。
未来计划