SpringBoot中swagger的使用
swagger組件有swagger editor 基于瀏覽器編輯器,swagger ui 可視化ui展示描述文件 ,swagger inspector 和ui組件很像,可以返回更多信息,會(huì)保存請(qǐng)求實(shí)際參數(shù),spring fox 是可以根據(jù)代碼生成接口文檔,所以描述文件是根據(jù)項(xiàng)目來(lái)變化的,不用手動(dòng)更新,springboot導(dǎo)入spring-fox依賴就是導(dǎo)入了wagger,在啟動(dòng)類上添加@EnableSwagger2注解,添加這個(gè)注解后表示啟動(dòng)項(xiàng)目就會(huì)啟動(dòng)swagger組件,對(duì)當(dāng)前項(xiàng)目全部控制器進(jìn)行掃描,訪問swagger-ui啟動(dòng)項(xiàng)目后在瀏覽器中輸入 http://ip:port/swagger-ui.html在swagger-ui中可視化操作項(xiàng)目接口,
swagger配置可以在項(xiàng)目中創(chuàng)建SwaggerConfig 配置對(duì)象來(lái)進(jìn)行配置文檔內(nèi)容Docket對(duì)象 通過這個(gè)對(duì)象配置描述文件信息通過apis()方法來(lái)設(shè)置哪些包中的內(nèi)容被掃描,
常用注解@Api是類上注解 控制了整個(gè)類生成接口信息的內(nèi)容,屬性tags 類的名字 description描述@ApiOperation 寫在方法上的注解,對(duì)方法進(jìn)行描述, 屬性value 方法描述 notes 提示信息@ApiParam 寫在方法參數(shù)中的注解,用于對(duì)參數(shù)進(jìn)行描述,說(shuō)明一下是否是必填項(xiàng),屬性有 name 參數(shù)名字 value參數(shù)描述 required是否是必須@ApiModel是類上注解,主要應(yīng)用在實(shí)體類上,屬性value 類名稱,description 是描述@ApiModelproperty可以應(yīng)用在方法上或是屬性上,用于方法參數(shù)是應(yīng)用類型時(shí)進(jìn)行定義描述@Apilgnore 用于類上方法上參數(shù)上,表示被忽視,
前后端分離一般使用vue+springboot后端:后端控制層 服務(wù)層 數(shù)據(jù)訪問層前端:前端控制層 視圖層前后端交互 API創(chuàng)建springboot項(xiàng)目 導(dǎo)入對(duì)應(yīng)的依賴

啟動(dòng)swagger界面查看

配置swaggerswagger有自己的配置實(shí)例對(duì)象 Docket這個(gè)對(duì)象方法中有多個(gè)屬性apiinfo屬性是配置swagger顯示的信息select()配置掃描接口groupname()配置api文檔的分組 配置多個(gè)Docket實(shí)例可以實(shí)現(xiàn)多個(gè)分組,多個(gè)@bean



到此這篇關(guān)于SpringBoot中swagger的使用的文章就介紹到這了,更多相關(guān)swagger的使用內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. php模擬實(shí)現(xiàn)斗地主發(fā)牌2. Python random庫(kù)使用方法及異常處理方案3. spring acegi security 1.0.0 發(fā)布4. jQuery 實(shí)現(xiàn)DOM元素拖拽交換位置的實(shí)例代碼5. MyBatis中的JdbcType映射使用詳解6. Vuex localStorage的具體使用7. Docker 容器健康檢查機(jī)制8. Vue封裝一個(gè)TodoList的案例與瀏覽器本地緩存的應(yīng)用實(shí)現(xiàn)9. vue 使用localstorage實(shí)現(xiàn)面包屑的操作10. 理解PHP5中static和const關(guān)鍵字

網(wǎng)公網(wǎng)安備