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

2024-06-11 300

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

309

内容来源：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

354

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

Spring

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

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。

WebStorm

WebStorm 是jetbrains公司旗下一款JavaScript 开发工具。目前已经被广大中国JS开发者誉为“Web前端开发神器”、“最强大的HTML5编辑器”、“最智能的JavaScript IDE”等。与IntelliJ IDEA同源，继承了IntelliJ IDEA强大的JS部分的功能。