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