什麼是Swagger？
Swagger是什麼：THE WORLD’S MOST POPULAR API TOOLING
根據官網的介紹：
Swagger Inspector：測試API和生成OpenAPI的開發工具。Swagger Inspector的建立是爲了解決開發者的三個主要目標。
執行簡單的API測試
生成OpenAPI文檔
探索新的API功能
如果想學習Java工程化、高性能及分佈式、深入淺出。微服務、Spring，MyBatis，Netty源碼分析的朋友可以加我的Java高級交流：854630135，羣裏有阿里大牛直播講解技術，以及Java大型互聯網技術的視頻免費分享給大家。
我的理解Swagger是一個規範和完整的框架，用於生成、描述、調用和可視化RESTful風格的Web服務。簡單來說，Swagger是一個功能強大的接口管理工具，並且提供了多種編程語言的前後端分離解決方案。根據我的使用，當然我只是最簡單的使用，我感覺Swagger有以下幾個優點：
Swagger可以整合到代碼中，在開發時通過註解，編寫註釋，自動生成API文檔。
將前端後臺分開，不會有過分的依賴。
界面清晰，無論是editor的實時展示還是ui的展示都十分人性化，如果自己僅僅用markdown來編寫，又要糾結該如何展現，十分痛苦。
構建項目
step1.導入依賴
io.springfox
springfox-swagger2
2.6.1
io.springfox
springfox-swagger-ui
2.6.1
org.springframework.boot
spring-boot-starter-web
org.springframework.boot
spring-boot-starter-test
test
**step2.編寫swagger配置類**
想要使用swagger功能必須提供配置類，主要配置ui界面信息，以及配置掃描位置，swagger會根據配置的路徑掃描所有的服務生成api。
其中核心RequestHandlerSelectors.basePackage("com.simple.spring.boot.controller"),在這裏配置我們的需要的掃描包位置。
如果想學習Java工程化、高性能及分佈式、深入淺出。微服務、Spring，MyBatis，Netty源碼分析的朋友可以加我的Java高級交流：854630135，羣裏有阿里大牛直播講解技術，以及Java大型互聯網技術的視頻免費分享給大家。
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket createRestApi() {
return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
.select()
.apis(RequestHandlerSelectors.basePackage("com.simple.spring.boot.controller"))
.paths(PathSelectors.any()).build();
}
private ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("Spring Boot中使用Swagger2構建RESTful APIs")
.description("myapp")
.termsOfServiceUrl("http://blog.csdn.net/SimpleWu")
.version("1.0").build();
}
}
**step3.編寫springboot啓動類**
@ComponentScan(basePackages={"com.simple.spring.boot.controller"}) 也是需要配置掃描路徑。
@SpringBootApplication
@ComponentScan(basePackages={"com.simple.spring.boot.controller"})
public class SwaggerApplication {
public static void main(String[] args) {
SpringApplication.run(SwaggerApplication.class, args);
}
}
**step4.創建前端控制器**
@RestController
@Api(tags = "swgger測試服務", description = "swgger測試服務")
@RequestMapping(value = "/simple/wu")
public class TestController {
@ApiOperation(value="測試POST方法", notes="測試POST方法")
@ApiImplicitParam(name = "令牌", value = "ID", required = true, dataType = "token")
@RequestMapping(value="hello", method=RequestMethod.POST)
public String post(@RequestBody String token) {
books.put(book.getId(), book);
return "success";
}
}
@Api(tags = "swgger測試服務", description = "swgger測試服務") 指定某個類提供服務的名字
@ApiOperation(value="測試POST方法", notes="測試POST方法") 指定某個請求的名字
@ApiImplicitParam(name = "令牌", value = "token", required = true, dataType = "String")指定名字對應參數爲令牌，以及對應參數字段token，required = true代表這個參數爲必填參數，dataType 代表數據類型。
step5.啓動服務
從上面的代碼中我們指定請求爲POST在UI界面上我們會看到一個服務名字爲swgger測試服務的大類點擊進去後可以看到裏面所擁有的請求，如果指定這個請求的類型那麼無法進行單元測試，指定後我們會看到一個請求名字叫做測試POST方法的請求並且需要填入必填參數token來完成我們的單元測試。
我們可以直接通過SwaggerApplication類來運行main方法來進行服務，端口號默認爲8080.
swagger地址：http://localhost:8080/swagger-ui.html 只需要在地址後面加上swagger-ui.html即可訪問
我們訪問這個位置即可看到UI界面，界面簡潔並且容易上手，我這邊就不截圖了。
step.總結
swagger官方文檔:https://www.baeldung.com/swagger-2-documentation-for-spring-rest-api
swagger的一個最大的優點是能實時同步api與文檔。
在項目開發過程中，發生過多次：修改代碼但是沒有更新文檔，前端還是按照老舊的文檔進行開發，在聯調過程中才發現問題的情況（當然依據開閉原則，對接口的修改是不允許的，但是在項目不穩定階段，這種情況很難避免）。
如果想學習Java工程化、高性能及分佈式、深入淺出。微服務、Spring，MyBatis，Netty源碼分析的朋友可以加我的Java高級交流：854630135，羣裏有阿里大牛直播講解技術，以及Java大型互聯網技術的視頻免費分享給大家。
