詳解如何在SpringBoot裡使用SwaggerUI

Swagger

Swagger是一種和語言無關的規範和框架，用於定義服務接口，主要用於描述RESTful的API。它專注於為API創建優秀的文檔和客戶端庫。支持Swagger的API可以為API方法生成交互式的文檔，讓用戶可以通過以可視化的方式試驗，查看請求和響應、頭文件和返回代碼，從而發現API的功能。

swagger用於定義API文檔。

好處：

1. 前後端分離開發
2. API文檔非常明確
3. 測試的時候不需要再使用URL輸入瀏覽器的方式來訪問Controller
4. 傳統的輸入URL的測試方式對於post請求的傳參比較麻煩（當然，可以使用postman這樣的瀏覽器插件）
5. spring-boot與swagger的集比較成簡單

SpringBoot嵌入SwaggerUI

步驟

1.jar包引入

<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.2.2</version> <scope>compile</scope></dependency><dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.2.2</version> <scope>compile</scope></dependency>

2.基於SpringBoot配置SwaggerConfig

 @Configuration@EnableSwagger2public class SwaggerConfig { @Bean public Docket newsApi() { //return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select().paths(PathSelectors.any()).build(); Docket docket = new Docket(DocumentationType.SWAGGER_2); docket.enable(true); docket.apiInfo(apiInfo()).select().paths(PathSelectors.any()).build(); return docket; } private ApiInfo apiInfo() { return new ApiInfoBuilder().title("訂單中心測試平台").description("在這裡你可以瀏覽項目所有接口，並提供相關測試工具") .termsOfServiceUrl("http://www-03.ibm.com/software/sla/sladb.nsf/sla/bm?Open").contact("test") .license("China Red Star Licence Version 1.0").licenseUrl("#").version("1.0").build(); }}

3.WebConfig配置說明

這裡有一個需要注意的問題，讓WebConfig去繼承WebMvcAutoConfigurationAdapter而不是直接繼承WebMvcConfigurerAdapter，否則Swagger的頁面出不來。

 @Configuration@EnableWebMvcpublic class WebConfig extends WebMvcAutoConfigurationAdapter { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**"); } @Bean public static PropertySourcesPlaceholderConfigurer propertySourcesPlaceholderConfigurer() { return new PropertySourcesPlaceholderConfigurer(); } @Bean public Filter characterEncodingFilter() { CharacterEncodingFilter characterEncodingFilter = new CharacterEncodingFilter(); characterEncodingFilter.setEncoding("UTF-8"); characterEncodingFilter.setForceEncoding(true); return characterEncodingFilter; } @Bean public MappingJackson2HttpMessageConverter converter() { MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter(); return converter; } @Bean public ViewResolver getViewResolver() { InternalResourceViewResolver resolver = new InternalResourceViewResolver(); resolver.setViewClass(JstlView.class); resolver.setPrefix("/jsp"); resolver.setSuffix(".jsp"); return resolver; } @Bean public StandardServletMultipartResolver getStandardServletMultipartResolver() { return new StandardServletMultipartResolver(); }}

4.SwaggerUI頁面訪問

http://localhost:8080/projectName/swagger-ui.html#!/

以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持武林網。