扔掉Swagger，試試這款功能強大，零注解侵入的API接口文檔生成工具！

介紹

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、Collection2.0+、OpenAPI 3.0+的文檔。

目前使用者

• 科大訊飛

• 小米

• 一加

• 順豐

---

特點

• 零注解、零學(xué)習(xí)成本、只需要寫標(biāo)準(zhǔn)JAVA注釋。
• 基于源代碼接口定義自動推導(dǎo)，強大的返回結(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。Up- 開放文檔數(shù)據(jù)，可自由實現(xiàn)接入文檔管理系統(tǒng)。
• 支持導(dǎo)出錯誤碼和定義在代碼中的各種字典碼到接口文檔。
• 支持Maven、Gradle插件式輕松集成。
• 支持Apache Dubbo RPC接口文檔生成。
• debug接口調(diào)試html5頁面完全支持文件上傳，下載(@download tag標(biāo)記下載方法)測試。

Smart-doc 從 2.0.0 后幾乎實現(xiàn)了 swagger ui 的功能，并且比 swagger ui 更簡潔大方，也更符合國內(nèi)開發(fā)者的訴求。

當(dāng)然 smart-doc 本身是只支持掃描代碼生成 openapi 3.0 的文檔的，也可以將生成的 openapi 3.0 文檔導(dǎo)入到其他ui中渲染展示。

學(xué)習(xí)資料：Java進階視頻資源

效果示例

1.1 接口文檔效果圖

1.2 html全局效果

更多了解，開源地址：https://gitee.com/smart-doc-team

?關(guān)注公眾號：Java后端編程，回復(fù)下面關(guān)鍵字?
要Java學(xué)習(xí)完整路線，回復(fù)??路線?
缺Java入門視頻，回復(fù)：?視頻?
要Java面試經(jīng)驗，回復(fù)??面試?
缺Java項目，回復(fù)：?項目?
進Java粉絲群：?加群?

PS：如果覺得我的分享不錯，歡迎大家隨手點贊、在看。
（完）




加我"微信"?獲取一份 最新Java面試題資料
請備注：666，不然不通過～

最近好文

1、GitHub 近兩萬 Star，可一鍵生成前后端代碼
2、Spring 官方為什么建議構(gòu)造器注入？
3、10000 字講清楚 Spring Boot 注解原理
4、13個優(yōu)秀的 Vue 開源項目及合集推薦
5、Java項目實戰(zhàn)：利用注解 + 反射消除重復(fù)代碼


最近面試BAT，整理一份面試資料《Java面試BAT通關(guān)手冊》，覆蓋了Java核心技術(shù)、JVM、Java并發(fā)、SSM、微服務(wù)、數(shù)據(jù)庫、數(shù)據(jù)結(jié)構(gòu)等等。
獲取方式：關(guān)注公眾號并回復(fù)?java?領(lǐng)取，更多內(nèi)容陸續(xù)奉上。
明天見(??ω??)??