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插件形式

---

?

使用效果

---

源碼和文檔地址

源碼，具體詳細使用方式以及Demo可參考：https://gitee.com/smart-doc-team/smart-doc

有道無術，術可成；有術無道，止于術

歡迎大家關注Java之道公眾號

好文章，我在看??

總結

以上是生活随笔為你收集整理的一款零注解API接口文档生成工具的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。