前言
swagger是一個流行的API開發框架,這個框架以“開放API聲明”(OpenAPI Specification,OAS)為基礎,對整個API的開發周期都提供了相應的解決方案,是一個非常龐大的項目(包括設計、編碼和測試,幾乎支持所有語言)。
OAS本身是一個API規范,它用於描述一整套API接口,包括一個接口是GET還是POST請求啊,有哪些參數哪些header啊,都會被包括在這個文件中。它在設計的時候通常是YAML格式,這種格式書寫起來比較方便,而在網絡中傳輸時又會以json形式居多,因為json的通用性比較強。
由於Spring的流行,Marty Pitt編寫了一個基於Spring的組件swagger-springmvc,用於將swagger集成到springmvc中來。而springfox則是從這個組件發展而來,同時springfox也是一個新的項目。
一. 依賴
1 <!--swagger--> 2 <!-- https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter --> 3 <dependency> 4 <groupId>io.springfox</groupId> 5 <artifactId>springfox-boot-starter</artifactId> 6 <version>3.0.0</version> 7 </dependency>
二. 問題所在(解決)
按照之前的swagger依賴來看,正常的 地址應該是 localhost:8080/swagger-ui.html
但是集成后倒入這個依賴,發現跳轉 404,說明出現問題了,去找源碼發現 集成的 依賴更改了地址,源碼和兩種方式如圖
默認地址: localhost:8080/swagger-ui/ 或者 localhost:8080/swagger-ui/index.html