最近一直遇到有人問我spring boot +swagger怎么配置無侵入式的restful接口,這段時間一直很忙,沒有時間,剛好星期六,趁著休息時間給大家寫個demo,在這里我就粘貼一些步驟,具體的源碼我就上傳到碼云上面吧,在這里我使用的工具是IDEA,大家可以搜搜了解下,蠻不錯的一個IDE
1.創(chuàng)建一個初始化,在這里為了節(jié)約基礎的配置我就選spring initalizr,idea在2014就已經(jīng)支持了,選擇下一步,然后進行一系列選擇
2.為了快速,我就不選數(shù)據(jù)庫那些,只選擇一個web,如果需要數(shù)據(jù)庫的話,無論是關系型數(shù)據(jù)庫還是非關系型數(shù)據(jù)庫,支持得都還好
3.項目基礎結構如下,因為自帶有maven的操作,我就把這邊的文件刪除掉
4.添加swagger的依賴,其實頁面返回的時候是json格式,還需要添加jackson的依賴,只是spring boot默認關系依賴就將jackson添加進來了
5.配置swagger
6.編寫測試controller,這里我們不需要對里面的controller和方法進行swagger配置,swagger會自動掃描所有的controller,如果沒有指定是請求的哪種方法,就會將七種(get,post,put,delete等等)都進行展示,如果設置了特定的請求方法,就只會展示特定的請求方法.
7.由于我其他地方使用了8080端口,所以我就使用80端口,一句話搞定,是不是特別簡單,因為springboot默認集成了tomcat等容器,至于支持的版本,可以搜下官網(wǎng)的說明文檔,要不就把tomcat升級到8.0以上,要么就手動配置tomcat的版本
8.開始運行,先clean,再package,然后再plugins里面spring-boot找到run,就可以運行了,如果你是java源文件,也可以直接找到主方法的類,run一下就okay
9.打開瀏覽器開始訪問啦 http://localhost:端口號/swagger-ui.html,我的訪問地址就是http://localhost/swagger-ui.html
