简介smart-doc是一款同时支持JAVARESTAPI和ApacheDubboRPC接口文档生成的工具。smart-doc在业界率先提出基于JAVA泛型定义的推导概念,完全基于接口源码分析生成接口文档,不使用任何注解侵入业务代码。你只需要按照java-doc标准编写注释,smart-doc可以帮你生成一个简单明了的Markdown、HTML5、Postman、Collection2.0+、OpenAPI3.0+文档。目前科大讯飞小米OnePlus顺丰速递的用户特点是零注解,零学习成本,只需要编写标准的JAVA注解即可。基于源码接口定义的自动推导,强大的返回结构推导。支持SpringMVC、SpringBoot、SpringBootWebFlux(控制器编写)、Feign。支持Callable、Future、CompletableFuture等异步接口返回的派生。支持JavaBean上的JSR303参数校验规范,包括组校验。JSON请求参数接口可以自动生成mockJSON参数。一些常用的字段定义可以生成有效的模拟值。支持生成JSON返回值示例。支持从项目外部加载源码生成字段注解(包括标准规范发布的jar包)。支持生成多种格式的文档:Markdown、HTML5、Asciidoctor、PostmanCollection、OpenAPI3.0。Up-开放文件资料,免费进入文件管理系统。支持将代码中定义的错误代码和各种字典代码导出到接口文档中。支持Maven、Gradle插件轻松集成。支持ApacheDubboRPC接口文档生成。调试接口调试html5页面,全面支持文件上传下载(@download标签标记下载方式)测试。smart-doc从2.0.0开始几乎实现了swaggerui的功能,而且比swaggerui更简洁大方,更符合国内开发者的诉求。当然,smart-doc本身只支持扫码生成openapi3.0文档,生成的openapi3.0文档也可以导入其他UI进行渲染展示。效果示例1.1接口文件效果图输入图片描述请求参数示例响应参数示例1.2html全局效果了解更多,开源地址:https://gitee.com/smart-doc-team近期文章推荐:Java1.1,000+频道面试题及答案(2021最新版)2.别再满脑子if/else了,试试策略模式,太爽了!!3.操!Java中xx≠null的新语法是什么?4、SpringBoot2.5发布,深色模式太炸了!5.《Java开发手册(嵩山版)》最新发布,赶快下载吧!感觉不错,别忘了点赞+转发!
