smart-doc 3.0.7 发布，支持生成 gRPC 协议接口文档

2024-08-19 351

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

重要更新内容

更新 SolonRequestMappingHandler.java。由 @aqnghu 在 https://github.com/TongchengOpenSource/smart-doc/pull/849 提交
功能：添加 Grpc 支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/851 提交
功能：添加 WebSocket 的 HTML 和 ASCII 文档支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/855 提交
修复：解决使用 Dubbo RPC或 @javadoc标签覆盖父类或接口但没有 Javadoc 注释时生成的接口文档缺乏描述信息的问题。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/866 提交
功能：添加对带有枚举类型键的 Map 的支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/870 提交
功能：添加对 @JsonView的支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/875 提交
依赖项更新：将 org.eclipse.jgit:org.eclipse.jgit 从 5.13.2.202306221912-r 升级到 5.13.3.202401111512-r。由 @dependabot 在 https://github.com/TongchengOpenSource/smart-doc/pull/782 提交
依赖项更新：将 org.slf4j:slf4j-api 从 2.0.13 升级到 2.0.16。由 @dependabot 在 https://github.com/TongchengOpenSource/smart-doc/pull/885 提
依赖项更新：将 com.ibeetl:beetl 从 3.16.2.RELEASE 升级到 3.17.0.RELEASE。由 @dependabot 在 https://github.com/TongchengOpenSource/smart-doc/pull/886 提交
依赖项更新：将 org.apache.maven.plugins:maven-gpg-plugin 从 3.2.4 升级到 3.2.5。由 @dependabot 在 https://github.com/TongchengOpenSource/smart-doc/pull/887 提交
依赖项更新：将 org.junit.jupiter:junit-jupiter 从 5.10.2 升级到 5.11.0。由 @dependabot 在 https://github.com/TongchengOpenSource/smart-doc/pull/888 提交
功能：添加对WebSocket消息和响应参数的支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/882 提交
修复（RPC）：修复构造 RPC 时发生的 ClassCastException 错误。由 @xiangganLuo 在 https://github.com/TongchengOpenSource/smart-doc/pull/890 提交
增强: 增强 IJavadocDocTemplate，为方法文档添加泛型支持。由 @linwumingshi 在 https://github.com/TongchengOpenSource/smart-doc/pull/891 提交

本次主要新增了gRPC协议接口文档的支持，对于在Java项目中实现的gRPC可以轻松生成接口文档，优化和完善了WebSocket文档，支持在文档中展示WebSocket的Message参数和相应参数。

当然无论是gRPC还是WebSocket都都属于近期版本才做的支持，对它们的标准化支持社区也是在摸着石头过河，我们也需要用户不断的反馈和迭代完善，因此欢迎社区用户多给我们提优化意见和测试用例。

新增贡献者

@Itswag

非常感谢上面的贡献者积极的参与社区贡献。

致谢

感谢 @linwumingshi 同学在本次的版本迭代种提供了对gRPC协议的支持

微信关注我们

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

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

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

x-easypdf v3.1.1 版本发布，新增表格对角线

x-easypdf是一个java语言简化处理pdf的框架，包含fop模块与pdfbox模块，fop模块以创建功能为主，基于xsl-fo模板生成pdf文档，以数据源的方式进行模板渲染；pdfbox模块以编辑功能为主，对标准的pdfbox进行扩展，添加了成吨的功能。本次更新内容如下：【pdfbox模块】新增字体添加别名新增字体描边颜色设置新增页眉页脚内容水平对齐方式新增页眉页脚内容垂直对齐方式新增表格单元格设置上下对角线新增文本组件设置上升值优化线条绘制逻辑优化默认字体【fop模块】修复自动扫描字体无线递归问题

2024-08-19

264

【文件传输工具】trzsz ( trz / tsz ) 发布 v1.1.8，支持后台传输，只要加上 -f 参数即可，如 trz -f 和 tsz -f xxx。服务端开源 GitHub：https://github.com/trzsz/trzsz-go 客户端开源 GitHub：https://github.com/trzsz/trzsz-ssh 服务端安装方法 Ubuntu 可用 apt 安装sudo apt install trzsz sudo apt update && sudo apt install software-properties-common sudo add-apt-repository ppa:trzsz/ppa && sudo apt update sudo apt install trzsz Debian 可用 apt 安装sudo apt install trzsz sudo apt install curl gpg curl -s 'https://keyserver.ubuntu.com/pks/l...

2024-08-19

309

资源下载

更多资源

优质分享App

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

Mario

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

腾讯云软件源

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

Nacos

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