swagger-bootstrap-ui 1.9.6 發布了。swagger-bootstrap-ui是 Swagger 的增強UI 實現,使文檔更友好一點兒
效果:http://swagger-bootstrap-ui.xiaominfo.com/doc.html
Gitee:https://gitee.com/xiaoym/swagger-bootstrap-ui
GitHub:https://github.com/xiaoymin/swagger-bootstrap-ui
示例:https://gitee.com/xiaoym/swagger-bootstrap-ui-demo
這是swagger-bootstrap-ui的最後一個版本
這是swagger-bootstrap-ui的最後一個版本
這是swagger-bootstrap-ui的最後一個版本
重要的事情說三遍!!!
一開始項目初衷是為了寫一個增強版本的Swagger 前端UI,但是隨著項目的發展,面對越來越多的個性化需求,不得不編寫後端Java代碼以滿足新的需求,在swagger-bootstrap-ui的1.8.5~1.9.6版本之間,採用的是後端Java代碼和Ui都混合在一個Jar包裡面的方式提供給開發者使用.這種方式雖說對於集成swagger來說很方便,只需要引入jar包即可,但是在微服務架構下顯得有些臃腫。
因此,項目正式更名為knife4j,取名knife4j是希望她能像一把匕首一樣小巧,輕量,並且功能強悍,更名也是希望把她做成一個為Swagger介面文檔服務的通用性解決方案,不僅僅只是專註於前端Ui前端.
swagger-bootstrap-ui的所有特性都會集中在knife4j-spring-ui
包中,並且後續也會滿足開發者更多的個性化需求.
主要的變化是,項目的相關類包路徑更換為com.github.xiaoymin.knife4j
前綴,開發者使用增強註解時需要替換包路徑
後端Java代碼和ui包分離為多個模塊的jar包,以面對在目前微服務架構下,更加方便的使用增強文檔註解(使用SpringCloud微服務項目,只需要在網關層集成UI的jar包即可,因此分離前後端)
knife4j沿用swagger-bootstrap-ui的版本號,第1個版本從1.9.6開始,關於使用方法,請參考文檔
由於更名給大家帶來的不便深表歉意~!
1、解決Spring路由PathVariable不顯示的情況,並優化交互體驗
2、解決響應體中的長整型顯示錯誤,精度丟失的問題#135 @GitHub
3、優化請求頭Header是中文的情況,如果包含中文則進行encodeURI函數處理,否則不做任何處理#140 @GitHub
4、升級jQuery 1.X系列版本到最新版本1.12.4
5、初始化頁面請求Swagger介面資源方式改為非同步,在jQuery的ajax方法參數項async:false
時,瀏覽器會拋出警告的問題(同步ajax請求會造成主線程阻塞,對用戶體驗不是很好,已被置為過時).
6、支持supportedSubmitMethods,後端配置UiConfiguration
的Bean#IVCQ0 @Gitee
7、優化下載中文亂碼問題,後端需要指定filename值,並且對名稱進行URLEncoder.encode處理,UI前端會進行decode成中文,保證下載正常
8、修復curl狀態欄複製時內容被轉義的bug#136 @GitHub
Maven坐標
com.github.xiaoymin swagger-bootstrap-ui 1.9.6
感謝各位朋友的支持,前往https://gitee.com/xiaoym/swagger-bootstrap-ui點個Star吧~~ :)
[admin
]