swagger-bootstrap-ui 1.9.6 發(fā)布了。swagger-bootstrap-ui是 Swagger 的增強(qiáng)UI 實(shí)現(xiàn)，使文檔更友好一點(diǎn)兒

文檔：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

重要說(shuō)明

這是swagger-bootstrap-ui的最后一個(gè)版本

這是swagger-bootstrap-ui的最后一個(gè)版本

這是swagger-bootstrap-ui的最后一個(gè)版本

重要的事情說(shuō)三遍!!!

一開(kāi)始項(xiàng)目初衷是為了寫(xiě)一個(gè)增強(qiáng)版本的Swagger 前端UI,但是隨著項(xiàng)目的發(fā)展,面對(duì)越來(lái)越多的個(gè)性化需求,不得不編寫(xiě)后端Java代碼以滿(mǎn)足新的需求,在swagger-bootstrap-ui的1.8.5~1.9.6版本之間,采用的是后端Java代碼和Ui都混合在一個(gè)Jar包里面的方式提供給開(kāi)發(fā)者使用.這種方式雖說(shuō)對(duì)于集成swagger來(lái)說(shuō)很方便,只需要引入jar包即可,但是在微服務(wù)架構(gòu)下顯得有些臃腫。

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

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

主要的變化是,項(xiàng)目的相關(guān)類(lèi)包路徑更換為com.github.xiaoymin.knife4j前綴,開(kāi)發(fā)者使用增強(qiáng)注解時(shí)需要替換包路徑

后端Java代碼和ui包分離為多個(gè)模塊的jar包,以面對(duì)在目前微服務(wù)架構(gòu)下,更加方便的使用增強(qiáng)文檔注解(使用SpringCloud微服務(wù)項(xiàng)目,只需要在網(wǎng)關(guān)層集成UI的jar包即可,因此分離前后端)

knife4j沿用swagger-bootstrap-ui的版本號(hào),第1個(gè)版本從1.9.6開(kāi)始,關(guān)于使用方法,請(qǐng)參考文檔

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

特性&優(yōu)化

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

2、解決響應(yīng)體中的長(zhǎng)整型顯示錯(cuò)誤,精度丟失的問(wèn)題#135 @GitHub

3、優(yōu)化請(qǐng)求頭Header是中文的情況,如果包含中文則進(jìn)行encodeURI函數(shù)處理,否則不做任何處理#140 @GitHub

4、升級(jí)jQuery 1.X系列版本到最新版本1.12.4

5、初始化頁(yè)面請(qǐng)求Swagger接口資源方式改為異步,在jQuery的ajax方法參數(shù)項(xiàng)async:false時(shí),瀏覽器會(huì)拋出警告的問(wèn)題(同步ajax請(qǐng)求會(huì)造成主線程阻塞,對(duì)用戶(hù)體驗(yàn)不是很好,已被置為過(guò)時(shí)).

6、支持supportedSubmitMethods,后端配置UiConfiguration的Bean#IVCQ0 @Gitee

7、優(yōu)化下載中文亂碼問(wèn)題,后端需要指定filename值,并且對(duì)名稱(chēng)進(jìn)行URLEncoder.encode處理,UI前端會(huì)進(jìn)行decode成中文,保證下載正常

8、修復(fù)curl狀態(tài)欄復(fù)制時(shí)內(nèi)容被轉(zhuǎn)義的bug#136 @GitHub

UI效果展示

項(xiàng)目地址

Maven坐標(biāo)

<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點(diǎn)個(gè)Star吧~~ ：）

標(biāo)簽： [db:TAGG]

版權(quán)申明：本站文章部分自網(wǎng)絡(luò)，如有侵權(quán)，請(qǐng)聯(lián)系：west999com@outlook.com
特別注意：本站所有轉(zhuǎn)載文章言論不代表本站觀點(diǎn)！
本站所提供的圖片等素材，版權(quán)歸原作者所有，如需使用，請(qǐng)與原作者聯(lián)系。