SpringBoot 集成Swagger2

一、入门

1、导入依赖

       
            org.springframework.boot
            spring-boot-configuration-processor
            true
        

        
        
            io.springfox
            springfox-swagger2
            2.9.2
        
        
        
            io.springfox
            springfox-swagger-ui
            2.9.2
        

2、添加配置

@Configuration
@EnableSwagger2//开启Swagger2
public class SwaggerConfig  {

    @Bean
    public Docket ProductApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .enable(true)
                .apiInfo(productApiInfo())
                .select()
                /**
                 * RequestHandlerSelectors 配置扫描接口方式
                 * basePackage 配置扫描的包
                 * any 扫描全部
                 * none 不扫描
                 * withClassAnnotation 扫描类上面的注解
                 * withMethodAnnotation 扫描方法上面的注解
                 */
                .apis(RequestHandlerSelectors.basePackage("com.sinux.health.system.controller"))
                /**
                 * 扫描过滤方式
                 * any 过滤全部
                 * none 不过滤
                 * regex 正则过滤
                 * ant 过滤指定路径
                 */
                .paths(PathSelectors.any())
                .build();

    }

    private ApiInfo productApiInfo() {
        ApiInfo apiInfo = new ApiInfo("XXX系统数据接口文档",
             "接口文档",
                "1.0",
                "192.168.3.181",
                "孙婷婷        联系人邮箱:[email protected]",
                "",
                "");
        return apiInfo;
    }
}

3、添加controller

/**
 * @Author：suntingting
 * @Date：2023/7/28 17:01
 * @Filename：UserController
 */
@RestController
@RequestMapping("user")
@Api(value = "用户", description = "用户管理")
public class UserController {

   
    @RequestMapping("/hello")
    public String hello() {
        return "hello word";
    }
}

访问：http://localhost:8888/swagger-ui.html#/

注意：可能会报404错误，需要添加配置,

No mapping for GET /swagger-ui.html

解决方案：

/**
 * @Author：suntingting
 * @Date：2023/7/31 11:17
 * @Filename：WebConfig
 */
@Configuration
public class WebConfig implements WebMvcConfigurer {

        @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {

        registry.addResourceHandler("/**").addResourceLocations(
                "classpath:/static/");
        registry.addResourceHandler("swagger-ui.html").addResourceLocations(
                "classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").addResourceLocations(
                "classpath:/META-INF/resources/webjars/");
        WebMvcConfigurer.super.addResourceHandlers(registry);
    }
}

这样就可以访问到了。

swagger-ui的访问窗口：

 

二、换肤

1、swagger-ui-layer

      
            com.github.caspar-chen
            swagger-ui-layer
            1.1.3
        

 皮肤：

 

2、swagger-bootstrap-ui

        
            com.github.xiaoymin
            swagger-bootstrap-ui
            1.9.1
        

3、knife4j-spring-ui

        
            com.github.xiaoymin
            knife4j-spring-ui
            2.0.8
        

皮肤：

 

个人比较喜欢knife4j-spring-ui。使用方便

 

注意：

1、换肤如果访问页面报404错误，说明没有找到对应的路径，需要修改WebConfig

 

  @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/doc.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**").
                addResourceLocations("classpath:/META-INF/resources/webjars/");
    }

中的registry.addResourceHandler("/doc.html")

配置对应的路径。