smart-doc 1.8.6 发布,Java 零注解文档生成工具
smart-doc是一个java restful api文档生成工具, smart-doc完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要写上java的标准注释,smart-doc就能帮你生成一个简易明了的Markdown、Html、AsciiDoc文档和Postman collection一键导入的测试数据。如果你不喜欢其他工具强侵入的注解污染,smart-doc给你一个不错的选择!喜欢smart-doc的用户也不要忘记给项目star,你们的支持是smart-doc持续推进的动力。
功能特性
- 零注解、零学习成本、只需要写标准java注释。
- 基于源代码接口定义自动推导,强大的返回结构推导。
- 支持Spring MVC,Spring Boot,Spring Boot Web Flux(controller书写方式)。
- 支持Callable,Future,CompletableFuture等异步接口返回的推导。
- 支持JavaBean上的JSR303参数校验规范,支持分组验证。
- 对json请求参数的接口能够自动生成模拟json参数。
- 对一些常用字段定义能够生成有效的模拟值。
- 支持生成json返回值示例。
- 支持从项目外部加载源代码来生成字段注释(包括标准规范发布的jar包)。
- 支持生成多种格式文档:Markdown、HTML5、Asciidoctor、Postman collection。
- 轻易实现在Spring Boot服务上在线查看静态HTML5 api文档。
- 开放文档数据,可自由实现接入文档管理系统。
- 一款代码注释检测工具,不写注释的小伙伴逃不过法眼了。
- 插件式快速集成(支持maven和gradle插件)
Smart-doc vs Swagger
- smart-doc不是对Swagger造轮子,这是一款用完全不同的理念重新开发的restful api接口文档生成工具。
- smart-doc比swagger集成更简单,可以自由生成多种格式的api文档。
- smart-doc完全不需要在侵入到业务代码中写任何注解。
更新内容
1. 增加localTime支持[gitee #I1F7CW](https://gitee.com/sunyurepository/smart-doc/issues/I1F7CW)。
2. 优化smart-doc导入Postman collection时的header问题[gitee #I1EX42](https://gitee.com/sunyurepository/smart-doc/issues/I1EX42)
3. 优化smart-doc-maven-plugin加载source的过滤,支持使用通配符来过滤。
4. 首次发布smart-doc-gradle-plugin插件1.0.0版本
5. 修复通用泛型解析出错[git #28](https://github.com/smart-doc-group/smart-doc/issues/28)。
maven插件
从smart-doc 1.7.9版本开始。我们提供了smart-doc的插件smart-doc-maven-plugin,推荐使用最新版本的插件。当然官方的gradle插件已经开发完毕,
gradle插件目前在测试阶段,使用gradle的用户可以先拉取gradle插件源码自行编译使用等待后续测试完发布。
升级建议
本次发布主要是发布了smart-doc-gradle-plugin插件,修复了用户提出的一些issue。入口并未发生变化,建议老版本的用户升级到最新。
DEMO
使用demo轻松玩转接口文档生成
知名用户
- 科大讯飞
- 一加
- 小米
相关文档
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
Debian 10.4 发布
Debian 10.4 已发布,这是 Debian 10 的第四个稳定版更新。此版本提供了稳定的软件包更新,重点放在安全修复程序和其他常规错误修复程序上。 部分更新内容包括: 内核版本更新,以及将内核 ABI 升级至 4.19.0-9 升级 ClamAV 至新版本 修复 LibreOffice 的 OpenGL 切换问题 禁用对 NCBI-Blast 的支持 升级至最新的 NVIDIA 图形驱动程以及一个广泛的安全更新 安全更新范围从 Firefox 到 Python 再到 Chromium …… 新版中修复了 libssh 的一个特定安全漏洞,0.8.9 和 0.9.4 之前的 libssh 版本都受到影响。若未完全初始化连接、且系统尝试清理,则该漏洞可导致客户端或服务器完全崩溃。 由于 Google API 的更改导致 Debian 10.4 删除了命令行 Google Play 下载程序的 gplaycli 软件包,因此该软件包也已被删除。由于 API 的更改,在此版本中,用于从 Hotmail 帐户提取电子邮件的 Getlive 也已被删除。其他丢弃的软件包括kerneloop...
- 下一篇
LLVM 10 影响 Rust 性能,导致编译时间变长
外媒 Phoronix 在进行基准测试后发现,与 LLVM/Clang 9.0 相比,Clang 10.0 的基准测试结果整体上不错,至少没有出现明显的倒退。但是,当 Rust 将其编译器基础迁移到 LLVM 10.0 后,对于 Rust 来说,情况似乎不太一样。 红帽公司的 Rust 开发者Josh Stone 在上周五发表邮件称,在编译相同的代码库时,LLVM 10.0 编译其 Git master 主分支代码不仅花费了更长的构建时间,而且生成了更多的指令。 Josh 和其他开发者发现,与使用 LLVM 9.0 相比,LLVM 10.0 会导致 Rust 编译时间变慢 7~8%。在邮件列表的一个帖子中,他指出从 LLVM 9.x 到 10.x 在测试代码库上生成的指令大约多了 5.3%,而从 LLVM 10.x 到 LLVM 11 Git master 分支,此项数据又增加了 4.8%。 这个问题目前尚未被解决,不过多个 Rust 开发者在 LLVM 10 中重现了同样的行为并得出相似的结果,并且从数据上看,问题对性能的影响比较大,希望不久后可以解决。
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- CentOS6,CentOS7官方镜像安装Oracle11G
- MySQL8.0.19开启GTID主从同步CentOS8
- CentOS7,8上快速安装Gitea,搭建Git服务器
- CentOS7编译安装Gcc9.2.0,解决mysql等软件编译问题
- SpringBoot2编写第一个Controller,响应你的http请求并返回结果
- 设置Eclipse缩进为4个空格,增强代码规范
- Springboot2将连接池hikari替换为druid,体验最强大的数据库连接池
- Jdk安装(Linux,MacOS,Windows),包含三大操作系统的最全安装
- Mario游戏-低调大师作品