一款零注解API接口文档生成工具
我是程序汪
共 1237字，需浏览 3分钟
· 2021-07-17
主要功能特性 使用形式 Maven插件形式 Gradle插件形式 使用效果 源码和文档地址 
smart-doc是一款同时支持JAVA REST API和Apache Dubbo RPC接口文档生成的工具，基于接口源码来分析生成接口文档，不采用任何注解侵入到业务代码中。只需要按照java-doc标准编写注释，smart-doc就能帮你生成一个简易明了的Markdown，或是一个像GitBook样式的静态html文档、以及Postman Collection2.0+、OpenAPI 3.0+的文档。
一改传统类似swagger这种大量采用注解侵入来生成文档的实现方法。
主要功能特性
支持接口Debug。 零注解、零学习成本、只需要写标准JAVA注释。 基于源代码接口定义自动推导，强大的返回结构推导。 支持Spring MVC、Spring Boot、Spring Boot Web Flux(controller书写方式)、Feign。 支持Callable、Future、CompletableFuture等异步接口返回的推导。 支持JavaBean上的JSR303参数校验规范，包括分组验证。 对JSON请求参数的接口能够自动生成模拟JSON参数。 对一些常用字段定义能够生成有效的模拟值。 支持生成JSON返回值示例。 支持从项目外部加载源代码来生成字段注释(包括标准规范发布的 jar 包)。 支持生成多种格式文档：Markdown、HTML5、Asciidoctor、Postman collection、Open Api 3.0+。 轻易实现在 Spring Boot 服务上在线查看静态 HTML5 api 文档。 支持Maven、Gradle插件式轻松集成。 支持 Apache Dubbo rpc 文档生成。
smart-doc从2.0.0后几乎实现了swagger ui的功能，并且比swagger ui更简洁大方，也更符合国内开发者的诉求。当然smart-doc的功能也已经 超过了Swagger为Java开发者提供的功能。
使用形式
Maven插件形式
Gradle插件形式
使用效果
推荐资源
欢迎添加程序汪个人微信 itwang007 进粉丝群或围观朋友圈
往期资源 需要请自取
喜欢就"在看"呗^_^
评论
FaceChain高保真人像风格生成挑战赛：一等奖方案
Datawhale分享 作者：马琦钧，Datawhale成员简 介大家好，我是马琦钧，Datawhale成员，毕业于浙江农林大学，统计学/会计学双学位，获得过由阿里云、谷歌、百度、CVPR、思否、极棒等举办的相关赛事奖项。本次主要分享 FaceChain 高保真人像风
Datawhale
1
OpenAI的Sora竟然造假：生成的AI大片只有1%的AI，剩下的99%是人工！
点蓝色字关注“机器学习算法工程师”设为星标，干货直达！啊？Sora火爆短片《气球人》，也“造假”了？？？背后艺术家团队的最新揭秘，可谓一石激起千层浪：原来，视频画面并非完全由AI生成，其中有大量视觉效果需要人类后期实现。be like：这下网友不干了，合着大家伙儿跟OpenAI玩真心，OpenAI背
机器学习算法工程师
1
中国人民大学《大语言模型》书籍中文版开放下载！还配套代码工具库~
大语言模型综述文章《A Survey of Large Language Models》团队终于出书啦！而且是中文版——《大语言模型》！这本书整理呈现了大模型技术框架和路线图，是一本非常好的入门书籍。🧿🧿🧿
此外，官方不仅发布了电子版 PDF 下载链接，还提供了配套资源。点赞 👍图书下载 → [大
机器学习算法与Python实战
0
让扩散模型听话的小秘籍？CAN：通过操控权重来控制条件生成模型，图像生成效率大升级！
↑ 点击蓝字 关注极市平台作者丨科技猛兽编辑丨极市平台极市导读 本文提出的 CAN 模型 (Condition-Aware Neural Network) 是一种对图像生成模型添加控制的方法。CAN 可以通过动态操纵神经网络的权重来控制图像生成过程。作者在 ImageNet 图像
极市平台
0
Open-Sora全面开源升级：支持16s视频生成和720p分辨率
机器之心发布 机器之心编辑部Open-Sora 在开源社区悄悄更新了，现在单镜头支持长达16秒的视频生成，分辨率最高可达720p，并且可以处理任何宽高比的文本到图像、文本到视频、图像到视频、视频到视频和无限长视频的生成需求。我们来试试效果。生成个横屏圣诞雪景，发b站再生成个竖屏，发抖音还能
机器学习算法与Python实战
0
强烈推荐一款好用到爆的可视化拖拽库
大厂技术 高级前端 Node进阶点击上方 程序员成长指北，关注公众号回复1，加入高级Node交流群今天给大家推荐这款拖拽组件VueDraggablePlus，试了一下非常不错，据说还被尤雨溪推荐过，咱们国人自己开发的，中国人不骗🇨🇳人，我就再来推
程序员成长指北
2
接口响应慢？那是你没用 CompletableFuture 来优化！
来源：blog.csdn.net/qq_43372633/article/details/130814200👉 欢迎加入小哈的星球 ，你将获得: 专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 / 赠书福利全栈前后端分离博客项目 2.0
小哈学Java
3
【第129期】程序员的新宠：三款终端工具，让你告别Xshell！
概述 WindTerm：跨平台的SSH利器 首先介绍的是WindTerm，这是一款使用C语言开发的跨平台SSH客户端。它不仅完全免费，而且没有商业使用的限制。WindTerm支持SSH v2、Telnet、Raw Tcp等协议，而且性能出色，甚至超过了FinalShell和Electerm。功能
前端微服务
0