Swagger API 接口文檔生成工具的利與弊

作爲Java後臺工程師其中的一員，作者深知衆多的開發者沒有寫接口文檔的習慣。尤其是一些新手，他們只想着把功能實現、和前端開發者把接口調試通就好了，沒有考慮到後期的項目維護。當他們接受一箇舊項目，進行二次開發的時候，突然發現看別人的代碼太難了，既沒有註釋，也沒有接口文檔，看懂一塊代碼邏輯要大半天，時間都浪費在了讀懂舊代碼上了。 爲了能夠偷懶(不寫接口文檔)，開發者發明了一種神器— Swagger ，

>>阅读原文<<