smart-doc是一个java restful api文档生成工具,smart-doc颠覆了传统类似swagger这种大量采用注解侵入来生成文档的实现方法。smart-doc完全基于接口源码分析来生成接口文档,完全做到零注解侵入,你只需要按照java标准注释的写就能得到一个标准的markdown接口文档。如果你已经厌倦了swagger等文档工具的注解和强侵入污染,那请拥抱smart-doc吧!
功能特性
- 零注解、零学习成本、易集成、只需要写标准java注释。
-
基于源代码接口定义自动推导( 唯一实现对象关联无限级自推导
)。
- 支持Spring MVC,Spring Boot。
- 目前支持javabean上定义的部分fastjson和jackson注解。
- 支持javabean上基于jsr303参数检验判断参数是否为必须。
- 对json请求参数的接口能够自动生成模拟json参数。
- 对一些常用字段定义能够生成有效的模拟值。
- 支持生成json返回值示例。
- 支持从项目外部加载源代码来生成字段注释。
- 一款代码注释检测工具,不写注释的小伙伴逃不过法眼了。
更新内容
升级建议
目前软件功能不断迭代,smart-doc的原始用户强烈建议升级到最新版。
下一版升级预告
目前smart-doc一些重要的功能已经完成开发,节后会发布下一个重大版本。下一次升级将意味着它将会为更多的开发者提供服务,
将会真正意义上成为众多java web开发者首选的api doc生成工具,也意味着留给swagger的时间不多了,需要的小伙伴请赶紧收藏好,。下一版功能预告(已进入测试阶段):
- 新增Spring Boot Web Flux(controller书写方式)。
- 新增Callable,Future,CompletableFuture等异步接口返回的推导支持。
- 修改过去版本中smart-doc生成文档中的一些细节。
-
重点
:新增生成静态html书签式api文档的功能实现在线查看api文档(可先预览smart-doc提供demo中的html文档)
DEMO
使用demo
轻松玩转接口文档生成
相关文档
关于java web restful api文档的重新探索
smart-doc功能使用介绍
原文
https://www.oschina.net/news/110057/smart-doc-1-6-4-released