支持Dubbo接口文檔生成的工具！

點擊上方藍(lán)色“程序猿DD”，選擇“設(shè)為星標(biāo)”

回復(fù)“資源”獲取獨家整理的學(xué)習(xí)資料！

作者 |?肥朝

Introduce

smart-doc是一款同時支持JAVA REST API和Apache Dubbo RPC接口文檔生成的工具，smart-doc在業(yè)內(nèi)率先提出基于JAVA泛型定義推導(dǎo)的理念， 完全基于接口源碼來分析生成接口文檔，不采用任何注解侵入到業(yè)務(wù)代碼中。你只需要按照java-doc標(biāo)準(zhǔn)編寫注釋， smart-doc就能幫你生成一個簡易明了的Markdown、HTML5文檔，甚至可以直接生成Postman Collection導(dǎo)入到Postman做API接口調(diào)試。

Features

• 零注解、零學(xué)習(xí)成本、只需要寫標(biāo)準(zhǔn)JAVA注釋。
• 基于源代碼接口定義自動推導(dǎo)，強(qiáng)大的返回結(jié)構(gòu)推導(dǎo)。
• 支持Spring MVC、Spring Boot、Spring Boot Web Flux(controller書寫方式)、Feign。
• 支持Callable、Future、CompletableFuture等異步接口返回的推導(dǎo)。
• 支持JavaBean上的JSR303參數(shù)校驗規(guī)范，包括分組驗證。
• 對JSON請求參數(shù)的接口能夠自動生成模擬JSON參數(shù)。
• 對一些常用字段定義能夠生成有效的模擬值。
• 支持生成JSON返回值示例。
• 支持從項目外部加載源代碼來生成字段注釋(包括標(biāo)準(zhǔn)規(guī)范發(fā)布的jar包)。
• 支持生成多種格式文檔：Markdown、HTML5、Asciidoctor、Postman Collection、OpenAPI 3.0。
• 輕易實現(xiàn)在Spring Boot服務(wù)上在線查看靜態(tài)HTML5 api文檔。
• 開放文檔數(shù)據(jù)，可自由實現(xiàn)接入文檔管理系統(tǒng)。
• 支持導(dǎo)出錯誤碼和定義在代碼中的各種字典碼到接口文檔。
• 支持Maven、Gradle插件式輕松集成。
• 支持Apache Dubbo RPC接口文檔生成。

Smart-doc生成文檔效圖

接口頭部效果圖

請求參數(shù)示例效果圖

請求參數(shù)示例

響應(yīng)參數(shù)示例效果圖

響應(yīng)參數(shù)示例

html文檔效果圖

html文檔

項目地址

開源地址：https://gitee.com/smart-doc-team/smart-doc

推薦關(guān)注這個勵志推薦10000個開源項目的兄弟

每天了解一個開源工具轉(zhuǎn)入你的兵器庫

【往期推薦】

36 張圖梳理 Intellij IDEA 常用設(shè)置

2020-12-23

13個Mongodb GUI可視化管理工具，總有一款適合你

2020-12-23

小宇宙爆發(fā)！Spring Boot 新特性：節(jié)省95%內(nèi)存占用

2020-12-22

超級干貨：你應(yīng)該知道的那些編程原則！！

2020-12-22

不敢相信，居然用Java寫了個“天天酷跑”！

2020-12-21

素質(zhì)二連，走一個