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

2024-06-11 254

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编号
修复post接口 content-type 为 form-data 和 urlencoded 时生成OpenAPI或者Postman导入工具变为GET方式的参数填充的bug.
支持扫描SpringBoot ControllerAdvice全局异常Handler生成 OpenAPI HTTP 错误状态（如 404、500 等）的描述
优化 ExampleBody 样例构建代码，以去除重复代码（ps: 一个来自在飞机上写下的PR）
泛型替换错误导致的解析 bug，例如构建一个多叉树对象结构体时。
优化：优化并重构smart-doc代码中很对常量定义，拓展了接口HTTP 错误状态自定生成能力。

本次版本迭代后经过测试，在Springboot 3.0.0+版本的框架下，smart-doc的OpenAPI生成能力甚至优于springdoc-openapi，在测试中发现OpenAPI UI对于一些接口生成的结构定义存在bug。

新增贡献者

@muyuanjin
@tuichenchuxin 来自Apache社区的贡献者

本次更新新增 2 位新的社区贡献者，非常感谢上面的两位贡献者积极的参与社区贡献。为社区的发展起到了非常积极的作用。

未来计划

新增 GRPC 支持(欢迎社区开发参与贡献)

微信关注我们

原文链接：https://www.oschina.net/news/296669/smart-doc-3-0-5-released

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

vxe-table 4.7.8 已经发布，vue 表格解决方案

vxe-table 4.7.8 已经发布，vue 表格解决方案此版本更新内容包括：更新 ts 类型 table 修复警告问题增加参数 expand-config.padding 详情查看：https://gitee.com/xuliangzhan_admin/vxe-table/releases/4.7.8

2024-06-11

270

内容来源：deepin（深度）社区 deepin-ports SIG（Special Interest Group，特别兴趣小组），deepin（深度）社区积极与各大厂商展开合作，参与对 RISC-V 架构和设备的适配工作。经过持续的努力，目前在 RISC-V 架构上已经完成了对大部分主流平台和开发板的支持，为 Linux 操作系统的生态系统增添了丰富的内容。最近，deepin（深度）社区成功完成了对 MilkV Mars 开发板的适配工作，并成功运行了 RISC-V 版本的 deepin V23。同时，他们即将发布适用于 MilkV Mars 的 deepin V23 Preview 版本，这无疑是 deepin 在多架构生态系统上取得的又一重要里程碑。这一成果的达成不仅标志着深度科技在多架构领域的积极探索和突破，也为 RISC-V 生态系统的进一步发展注入了新的活力。 MilkV Mars Milk-V Mars 是由群芯闪耀推出的一款采用 StarFive JH7110 芯片的、第一款信用卡大小的高性能 RISC-V 单板计算机（SBC）。 Milk-V Mars 搭载了四核高...

2024-06-11

320

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称，一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring框架（Spring Framework）是由Rod Johnson于2002年提出的开源Java企业级应用框架，旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念，提供核心容器、应用上下文、数据访问集成等模块，支持整合Hibernate、Struts等第三方框架，其适用范围不仅限于服务器端开发，绝大多数Java应用均可从中受益。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。