springmvc整合swagger2.x

1、新增swagger依赖

        <!-- swagger -->  
        <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、新增swagger配置类

@Configuration //声明该类为配置类
@EnableSwagger2 //声明启动Swagger2
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage(“com.demo.controller”))
                .paths(PathSelectors.any())
                .build();
    }

}

3、修改spring配置

修改包扫描配置

<context:component-scan base-package="com.demo.controller">
    <!-- 把Controller、RestController 的注解排除掉，在spring-mvc.xml单独扫描Controller注解 -->
    <context:exclude-filter type="annotation"  expression="org.springframework.stereotype.Controller" />
    <context:exclude-filter type="annotation"  expression="org.springframework.web.bind.annotation.RestController" />
    
    <!--由于controller在spring-mvc配置中加载，然后swagger也要在mvc中加载才能扫描到controller，所以不需要在spring加载-->
    <context:exclude-filter type="regex" expression="com.demo.config.SwaggerConfig"/>
    
</context:component-scan>

4、修改spring-mvc配置

4.1、修改包扫描配置

<context:component-scan base-package="com.demo" use-default-filters="false">
    <context:include-filter type="annotation"  expression="org.springframework.stereotype.Controller" />
    <context:include-filter type="annotation"  expression="org.springframework.web.bind.annotation.RestController" />
    <!--加载swagger配置类-->
    <context:exclude-filter type="regex" expression="com.demo.config.SwaggerConfig"/>
</context:component-scan>

4.2、增加swagger相关配置

   <!-- swagger -->
   <mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/"/>
   <mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/"/> 

参考文章：

https://blog.csdn.net/jakekong/article/details/112346392
https://blog.csdn.net/lovelichao12/article/details/79387569