項目背景

2019-05-30 20:54 更新

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

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

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

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

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

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

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

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

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號