項(xiàng)目背景

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

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

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

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

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

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

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

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