smart-doc 1.7.3 发布,Java 零注解文档生成工具
smart-doc是一个java restful api文档生成工具,smart-doc颠覆了传统类似swagger这种大量采用注解侵入来生成文档的实现方法。 smart-doc完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要按照java标准注释的写,smart-doc就能帮你生成一个简易明了的Markdown、Html、AsciiDoc文档。如果你已经厌倦了swagger等文档工具的无数注解和强侵入污染,那请拥抱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。
- 轻易实现在Spring Boot服务上在线查看静态HTML5 api文档。
- 开放文档数据,可自由实现接入文档管理系统。
- 一款代码注释检测工具,不写注释的小伙伴逃不过法眼了。
Smart-doc vs Swagger
- smart-doc不是对Swagger造轮子,这是一款用完全不同的理念重新开发的restful api接口文档生成工具。
- smart-doc比swagger集成更简单,可以自由生成多种格式的api文档。
- smart-doc完全不需要在侵入到业务代码中写任何注解,复杂嵌套对象自动推导出定义字段结构。
- smart-doc代码量很少,如果不能满足你的需求完全可以自己修改源码。
更新内容
- 优化html5模板左侧文档目录展示,能够展开和收缩。
- 修改gitee上bug #I13R3K。
- 修改gitee上bug #I13NR1。
- 开放的文档数据获取接口添加返回方法的唯一id和方法名称。
升级建议
这个版本修改了一些用不提交的bug问题,某一bug容易被触发建议升级,smart-doc升级基本属于平滑升级。
DEMO
使用demo轻松玩转接口文档生成
相关文档
低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。
持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。
转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。
- 上一篇
GoAdmin 发布 v1.0.3 版本,新增主题 sword
GoAdmin于10月8号发布1.0测试版本,经过半个月测试,目前已推出1.0正式版。本次更新,主要修复了一些界面上bug,同时对命令行工具进行改进,以及在adminlte之后,推出了新的主题sword。欢迎下载体验。 介绍 GoAdmin是一款基于golang的后台数据可视化管理搭建工具。致力于简化saas,数据可视化系统搭建难度,提升golang开发效率,将高效率高性能的体验带给所有开发者。 产品截图 在线demo http://demo.go-admin.cn/admin 官网 http://www.go-admin.cn 文档 http://www.go-admin.cn/docs 新手极速上手例子 https://gitee.com/go-admin/example
- 下一篇
加量不加价的突发实例t5 baseline上手评测
什么是突发实例传统云服务当用户购买ECS之后,拥有CPU 100%的资源使用权,但是对大部分应用场景比如压力测试,嵌入式交叉编译服务器,web应用服务器等应用场景来说,仅在特定的一段时间,CPU占用可能会比较高,这种情况下,就可以选择突发实例。突发实例价格降低很多的同时,将CPU20%左右的资源作为基准,低于的时候计算积分,超过的时候扣分。 突发实例够用吗只要用户购买前评估业务平峰期和高峰期的实例性能需求,至少选择基准性能满足平峰期需求的实例规格,选择得当可以在满足整体性能需求的同时节省非常多的服务器成本。在售的突发性能实例规格族有t5、t6,详细信息请参见突发性能实例规格族t5和突发性能实例规格族t6。 以t5为例评测一下突发实例性能 购买打开阿里云官网进入ECS服务器购买页面,选择入门级(共享)型设备,然后选择突发性能实例t5, 1C2G设备,可以看到基准CPU使用率已经由10%提高到20%安装初始镜像如果选择普通板的系统镜像,需要安装nginx mysql php等web环境时,如果选择源码编译,可以看到CPU占用率持续飙高。凌晨0:47分第一次接近100%大概持续了40分钟,在...
相关文章
文章评论
共有0条评论来说两句吧...
文章二维码
点击排行
推荐阅读
最新文章
- CentOS6,CentOS7官方镜像安装Oracle11G
- CentOS7安装Docker,走上虚拟化容器引擎之路
- CentOS7设置SWAP分区,小内存服务器的救世主
- Docker使用Oracle官方镜像安装(12C,18C,19C)
- CentOS7编译安装Gcc9.2.0,解决mysql等软件编译问题
- CentOS7编译安装Cmake3.16.3,解决mysql等软件编译问题
- CentOS8安装Docker,最新的服务器搭配容器使用
- Docker安装Oracle12C,快速搭建Oracle学习环境
- CentOS关闭SELinux安全模块
- CentOS6,7,8上安装Nginx,支持https2.0的开启