這次,Swagger-ui遇到對手了!
介紹
knife4j是為Java MVC框架集成Swagger生成Api文檔的增強解決方案(在非Java項目中也提供了前端UI的增強解決方案),前身是swagger-bootstrap-ui,取名knife4j是希望她能像一把匕首一樣小巧,輕量,并且功能強悍!
開源倉庫
Github
https://github.com/xiaoymin/swagger-bootstrap-ui
碼云
https://gitee.com/xiaoym/knife4j
功能特性
簡潔 基于左右菜單式的布局方式,是更符合國人的操作習(xí)慣吧.文檔更清晰... 個性化配置 個性化配置項,支持接口地址、接口description屬性、UI增強等個性化配置功能... 增強 接口排序、Swagger資源保護、導(dǎo)出Markdown、參數(shù)緩存眾多強大功能...
功能預(yù)覽
在線預(yù)覽
http://knife4j.xiaominfo.com/doc.html
選擇不同接口
Authorize
swagger實體
包含了swagger實體的相關(guān)信息
swagger全局設(shè)置
全局參數(shù)設(shè)置
離線文檔導(dǎo)出
Knife4j提供導(dǎo)出4種格式的離線文檔(Html\Markdown\Word\Pdf)
個性化設(shè)置
api文檔
搜索功能
使用簡介
項目結(jié)構(gòu)
目前主要的模塊
目前主要的模塊包括:
knife4j??#為Java?MVC框架集成Swagger的增強解決方案
knife4j-admin??#云端Swagger接口文檔注冊管理中心,集成gateway網(wǎng)關(guān)對任意微服務(wù)文檔進行組合集成
knife4j-extension??#chrome瀏覽器的增強swagger接口文檔ui,快速渲染swagger資源
knife4j-service??#為swagger服務(wù)的一系列接口服務(wù)程序
knife4j-front?#knife4j-spring-ui的純前端靜態(tài)版本,用于集成非Java語言使用
swagger-bootstrap-ui??#knife4j的前身,最后發(fā)布版本是1.9.6
單純皮膚增強
不使用增強功能,純粹換一個swagger的前端皮膚,這種情況是最簡單的,你項目結(jié)構(gòu)下無需變更
可以直接引用swagger-bootstrap-ui的最后一個版本1.9.6或者使用knife4j-spring-ui
老版本引用
????
??com.github.xiaoymin ????
??swagger-bootstrap-ui ????
??1.9.6
新版本引用
????
??com.github.xiaoymin ????
??knife4j-spring-ui ????
??${lastVersion}
Spring Boot項目單體架構(gòu)使用增強功能
在Spring Boot單體架構(gòu)下,knife4j提供了starter供開發(fā)者快速使用
????
??com.github.xiaoymin ????
??knife4j-spring-boot-starter ????
??${knife4j.version}
該包會引用所有的knife4j提供的資源,包括前端Ui的jar包
Spring Cloud微服務(wù)架構(gòu)
在Spring Cloud的微服務(wù)架構(gòu)下,每個微服務(wù)其實并不需要引入前端的Ui資源,因此在每個微服務(wù)的Spring Boot項目下,引入knife4j提供的微服務(wù)starter
????
??com.github.xiaoymin ????
??knife4j-micro-spring-boot-starter ????
??${knife4j.version}
在網(wǎng)關(guān)聚合文檔服務(wù)下,可以再把前端的ui資源引入
????
???com.github.xiaoymin ????
???knife4j-spring-boot-starter ????
???${knife4j.version}
總結(jié)
針對knife4j的總結(jié),無非就是牛逼來形容,切實的解決了swagger ui不夠友好的問題,而且還可以集成到其他語言的api項目中,真真切切的需要感謝開發(fā)作者提供了這么好的工具供我們使用,小伙伴是不是心動了,趕緊去試試吧!enjoy it!
?關(guān)注公眾號:Java后端編程,回復(fù)下面關(guān)鍵字?
要Java學(xué)習(xí)完整路線,回復(fù)??路線?
缺Java入門視頻,回復(fù):?視頻?
要Java面試經(jīng)驗,回復(fù)??面試?
缺Java項目,回復(fù):?項目?
進Java粉絲群:?加群?
PS:如果覺得我的分享不錯,歡迎大家隨手點贊、在看。
(完) 加我"微信"?獲取一份 最新Java面試題資料 請備注:666,不然不通過~
最近好文
2、Java學(xué)生宿舍管理系統(tǒng),附上源碼 !
最近面試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ù)奉上。 明天見(??ω??)??











