Swagger2 WebFlux小试牛刀

序

本文主要展示一下如何使用支持WebFlux的Swagger

maven

        
            io.springfox
            springfox-swagger2
            ${swagger.version}
        
        
            io.springfox
            springfox-spring-webflux
            ${swagger.version}
        
        
            io.springfox
            springfox-swagger-ui
            ${swagger.version}
        

• swagger.version目前是3.0.0-SNAPSHOT，因而没有发布到maven官方仓库里头，需要从jcenter-snapshots中拉取

    
        
            jcenter-snapshots
            jcenter
            http://oss.jfrog.org/artifactory/oss-snapshot-local/
        
    

配置

@Configuration
@EnableSwagger2WebFlux
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(new ApiInfoBuilder()
                        .description("example api")
                        .title("example api")
                        .version("1.0.0")
                        .build())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
                .paths(PathSelectors.any())
                .build();

    }
}

• 由于支持了WebFlux，所以之前的@EnableSwagger2就移除掉了，变为@EnableSwagger2WebMvc以及@EnableSwagger2WebFlux，这里使用的是@EnableSwagger2WebFlux

小结

• Spring 5引入了WebFlux，而当前版本的SpringFox Swagger2(2.9.2)还不支持WebFlux，得使用3.0.0-SNAPSHOT才支持
• 由于是SNAPSHOT版本，因而没有发布到maven官方仓库里头，需要从jcenter-snapshots中拉取，另外要使用支持WebFlux的Swagger2需要引入springfox-spring-webflux依赖
• 由于支持了WebFlux，所以之前的@EnableSwagger2就移除掉了，变为@EnableSwagger2WebMvc以及@EnableSwagger2WebFlux

doc

• springfox docs snapshot
• spring-boot-webflux-swagger-starter
• Maven repository for springfox-spring-webflux ? #2939