V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
• 请不要在回答技术问题时复制粘贴 AI 生成的内容
smartdoc647
V2EX  ›  程序员

smart-doc 3.1.1 发布, Java 零注解 API 文档生成工具

  •  
  •   smartdoc647 · 7 天前 · 692 次点击

    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

    重要更新内容

    修复 map 类型 key 的类型检查错误。 修复 response 字段使用 @JsonProperty(access = JsonProperty.Access.READ_ONLY)时文档生成错误的 修复 openapi 生成上的多个 bug

    未来计划

    AI 虽然聪明,但是当前 smart-doc 服务的领域无论是在生成速度和准确度都远超 AI, 未来我们会持续更新支持 idea 插件

    1 条回复    2025-06-30 18:18:18 +08:00
    pisay
        1
    pisay  
       7 天前
    加油,用了很多年了 希望越来越好!
    关于   ·   帮助文档   ·   自助推广系统   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   939 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 21:44 · PVG 05:44 · LAX 14:44 · JFK 17:44
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.