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