您好,登錄后才能下訂單哦!
這篇文章主要講解了“Swagger的原理及應用”,文中的講解內容簡單清晰,易于學習與理解,下面請大家跟著小編的思路慢慢深入,一起來研究和學習“Swagger的原理及應用”吧!
OpenAPI規范是Linux基金會的一個項目,試圖通過定義一種用來描述API格式或API定義的語言,來規范RESTful服務開發過程。
Swagger是全球最大的OpenAPI規范API開發工具框架,支持從設計到文檔到測試和部署到整個API生命周期的開發。Spring Boot可以集成Swagger,生成Swagger接口。
在Java類中添加Swagger的注解即可生成Swagger接口。
常用的Swagger注解:
@Api:修飾整個類,描述Controller的作用,
@ApiOperation:描述一個類的一個方法,或者說一個接口
@ApiParam:單個參數描述
@ApiModel:用對象來接收參數
@ApiModelProperty:用對象接收參數時,描述對象的一個字段
@ApiResponse:HTTP響應其中1個描述
@ApiResponses:HTTP響應整體描述
@ApiIgnore:使用該注解忽略這個API
Swagger接口生成工作原理:
1、系統啟動時,掃描Swagger的配置類
2、在此類中指定來要掃描的包路徑,找到在此包下及子包下標記@RestController注解的controller類
3、根據controller類中的Swagger注解生成接口文檔
啟動項目,訪問項目虛擬路徑/swagger-ui,查看生成的項目
@ApiError:發送錯誤返回的信息
@ApiImplicitParam:一個請求參數
@ApiImplicitParams:多個請求參數
感謝各位的閱讀,以上就是“Swagger的原理及應用”的內容了,經過本文的學習后,相信大家對Swagger的原理及應用這一問題有了更深刻的體會,具體使用情況還需要大家實踐驗證。這里是億速云,小編將為大家推送更多相關知識點的文章,歡迎關注!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。