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

2024-06-11 240

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

256

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

307

资源下载

更多资源

Mario

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

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Nacos

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

Sublime Text

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