項(xiàng)目背景

大概是在2017年4月份,我們團(tuán)隊(duì)整個(gè)開(kāi)發(fā)方式都決定使用前后端分離的方式來(lái)合作開(kāi)發(fā),前后端分離當(dāng)時(shí)整個(gè)技術(shù)方案也是由我來(lái)負(fù)責(zé)整理，探索，如何讓整個(gè)團(tuán)隊(duì)更高效的開(kāi)發(fā)，完成自己的本職工作.從一開(kāi)始的jsonp，到后面nginx反向代理，這里面我也收獲了很多東西，也寫(xiě)了一些相關(guān)的博客總結(jié)，

但最讓人頭疼的還是前后端如何針對(duì)接口來(lái)對(duì)接，當(dāng)時(shí)找了很多解決方案，一開(kāi)始使用的是叫apidocs的，有些類(lèi)似于寫(xiě)java的注釋?zhuān)褂闷饋?lái)還是不錯(cuò)的，不過(guò)沒(méi)有在線(xiàn)生成的，文檔寫(xiě)完后需要單獨(dú)命令來(lái)生成一個(gè)文檔，挺麻煩，后來(lái)就放棄了

最終就考慮使用swagger來(lái)做文檔的這塊，但swagger大家都知道，swagger的ui雖然能把文檔說(shuō)清楚，但是不怎么好用，可能不適合我們國(guó)人的眼光吧，至少我是這么認(rèn)為的，所以當(dāng)時(shí)也就想看看swagger的生成方式，swagger-bootstrap-ui就因此誕生了

這里談?wù)剆wagger，雖然很多人噴他，不好用，基于注解，代碼入侵很強(qiáng)，等等 很多原因。但總體來(lái)看，swagger發(fā)展至今，包括在各個(gè)語(yǔ)言，nodeJs、.net、java、php等等，它可以說(shuō)是一個(gè)有些接口規(guī)范的東西，從開(kāi)始，到一步步規(guī)范，其實(shí)是一個(gè)很艱難的過(guò)程，任何事物，都不是盡善盡美的，swagger也是一樣，至少它給這么多語(yǔ)言提供了一種文檔生成的解決方案，其價(jià)值就遠(yuǎn)超它本身的缺點(diǎn)

在Java里面，是springfox實(shí)現(xiàn)了swagger的接口方式，其他語(yǔ)言也類(lèi)似.

鄙人一直覺(jué)得如果前面有人開(kāi)發(fā)出來(lái)這個(gè)東西，而且用戶(hù)范圍，穩(wěn)定性都相對(duì)較高的情況下，這個(gè)東西一定是有他的意義存在的，站在巨人的肩膀上，做正確的事，一直是我認(rèn)為符合實(shí)際情況的,起碼你不用自己填坑，因?yàn)椋鲩_(kāi)源，一個(gè)想法在當(dāng)時(shí)，可能比較新穎，關(guān)注度很高，但是我想，大部分人都逃離不了惰性，缺少的是持之以恒，特別是在中國(guó)，很多開(kāi)源其實(shí)都是個(gè)人在做（包括我自己的這個(gè)swagger-bootstrap-ui），意識(shí)上，相對(duì)國(guó)外還是比較薄弱的,而且還有精力，鍥而不舍，任重而道遠(yuǎn)矣~！

所以，swagger-bootstrap-ui僅僅只是一個(gè)ui包，里面不包括任何Java代碼，基于swagger，希望為swagger的生態(tài)發(fā)展做一份貢獻(xiàn)。

swagger-bootstrap-ui開(kāi)源至今也有一年4月有余了，為自己一直堅(jiān)持下來(lái)打call，也會(huì)一直堅(jiān)持下去，繼續(xù)維護(hù)它，東西雖小,但堅(jiān)持下去總會(huì)有收獲.