swagger-bootstrap-ui 1.9.6 發(fā)布了。swagger-bootstrap-ui是 Swagger 的增強UI 實現，使文檔更友好一點兒

文檔：http://doc.xiaominfo.com

效果：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,但是隨著項目的發(fā)展,面對越來越多的個性化需求,不得不編寫后端Java代碼以滿足新的需求,在swagger-bootstrap-ui的1.8.5~1.9.6版本之間,采用的是后端Java代碼和Ui都混合在一個Jar包里面的方式提供給開發(fā)者使用.這種方式雖說對于集成swagger來說很方便,只需要引入jar包即可,但是在微服務架構下顯得有些臃腫。

因此,項目正式更名為knife4j,取名knife4j是希望她能像一把匕首一樣小巧,輕量,并且功能強悍,更名也是希望把她做成一個為Swagger接口文檔服務的通用性解決方案,不僅僅只是專注于前端Ui前端.

swagger-bootstrap-ui的所有特性都會集中在knife4j-spring-ui包中,并且后續(xù)也會滿足開發(fā)者更多的個性化需求.

主要的變化是,項目的相關類包路徑更換為com.github.xiaoymin.knife4j前綴,開發(fā)者使用增強注解時需要替換包路徑

后端Java代碼和ui包分離為多個模塊的jar包,以面對在目前微服務架構下,更加方便的使用增強文檔注解(使用SpringCloud微服務項目,只需要在網關層集成UI的jar包即可,因此分離前后端)

knife4j沿用swagger-bootstrap-ui的版本號,第1個版本從1.9.6開始,關于使用方法,請參考文檔

由于更名給大家?guī)�來的不便深表歉意~！

特性&優(yōu)化

1、解決Spring路由PathVariable不顯示的情況，并優(yōu)化交互體驗

2、解決響應體中的長整型顯示錯誤,精度丟失的問題#135 @GitHub

3、優(yōu)化請求頭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、優(yōu)化下載中文亂碼問題,后端需要指定filename值,并且對名稱進行URLEncoder.encode處理,UI前端會進行decode成中文,保證下載正常

8、修復curl狀態(tài)欄復制時內容被轉義的bug#136 @GitHub

UI效果展示

項目地址

Maven坐標

<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>swagger-bootstrap-ui</artifactId>
   <version>1.9.6</version>
</dependency>

STAR & ISSUE

感謝各位朋友的支持,前往https://gitee.com/xiaoym/swagger-bootstrap-ui點個Star吧~~ ：）

標簽： [db:TAGG]

版權申明：本站文章部分自網絡，如有侵權，請聯系：west999com@outlook.com
特別注意：本站所有轉載文章言論不代表本站觀點！
本站所提供的圖片等素材，版權歸原作者所有，如需使用，請與原作者聯系。