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

2024-08-19 303

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

229

【文件传输工具】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

271

资源下载

更多资源

Mario

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

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文件系统，支持十年生命周期更新。

Sublime Text

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