Springboot 集成Swagger2配置

1、添加Swagger2的Maven依赖

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.9.2</version>
    </dependency>
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.9.2</version>
    </dependency>

2、编写Swagger2配置类

@Configuration
public class Swagger2 {
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.xx.zmn.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("xxx系统后台api文档")
                .description("系统api")
                .version("1.0")
                .build();
    }
}

3、编写WebConfig配置类，配置静态页面访问

@Configuration
public class WebConfig extends WebMvcConfigurationSupport {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        /** 配置静态文件访问路径，静态文件存放在static文件目录下*/
        registry.addResourceHandler("/**")
        		.addResourceLocations("classpath:/static/");
        registry.addResourceHandler("/webjars/**")
        		.addResourceLocations("classpath:META-INF/resources/webjars/");
        //配置swagger2
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
    }
}

4、Springboot启动类添加@EnableSwagger2注解开启文档

@SpringBootApplication
@EnableSwagger2
public class ZmnApplication {

    public static void main(String[] args) {
        SpringApplication.run(ZmnApplication.class, args);
    }
}

5、浏览器访问地址：http://localhost:8080/swagger-ui.html

注意：http://localhost:8080是项目访问根路径