<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->

<dependency>

    <groupId>io.springfox</groupId>

    <artifactId>springfox-swagger2</artifactId>

    <version>2.8.0</version>

</dependency>

<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->

<dependency>

    <groupId>io.springfox</groupId>

    <artifactId>springfox-swagger-ui</artifactId>

    <version>2.8.0</version>

</dependency>

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.core.env.Environment;

import org.springframework.core.env.Profiles;

import springfox.documentation.builders.PathSelectors;

import springfox.documentation.builders.RequestHandlerSelectors;

import springfox.documentation.service.ApiInfo;

import springfox.documentation.service.Contact;

import springfox.documentation.spi.DocumentationType;

import springfox.documentation.spring.web.plugins.Docket;

import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;

@Configuration

@EnableSwagger2

public class SwaggerConfig {

    @Bean //配置docket以配置Swagger具体参数

    public Docket docket(Environment environment) {

        //动态配置项目所属什么环境时来显示swagger

        // 设置要显示swagger的环境

//        Profiles of = Profiles.of("dev", "test");

        // 判断当前是否处于该环境

        // 通过enable()方法接收此参数判断是否要显示

//        boolean flag = environment.acceptsProfiles(of);

        return new Docket(DocumentationType.SWAGGER_2)

                //配置文档页面信息

                .apiInfo(apiInfo())

                //动态配置是否启用Swagger，如果是false，在浏览器将无法访问

//                .enable(flag)

                //配置分组

                //配置多个分组只需要配置多个docket即可，不同docket有不同组名

                .groupName("组名")

                //构建Docket时通过select()方法扫描接口

                .select()

                //RequestHandlerSelectors：配置要扫描接口的方式

                    //1、扫描所有，项目中的所有接口都会被扫描到：any()

                    //2、不扫描接口：none()

                    //3、扫描方法上的注解：withMethodAnnotation（），

                            // 如withMethodAnnotation(GetMapping.class)只扫描get请求

                    //4、扫描类上的注解，参数是一个反射对象：withClassAnnotation（），

                            // 如.withClassAnnotation(Controller.class)只扫描有controller注解的类中的接口

                    //5、指定要扫描的包路径：basePackage(final String basePackage)

                //例：.apis(RequestHandlerSelectors.basePackage("com.swagger.controller"))

                .apis(RequestHandlerSelectors.basePackage("控制类所在包名"))

                //配置如何通过path过滤,即这里只扫描请求以/controller开头的接口

                    //1、任何请求都扫描：any()

                    //2、任何请求都不扫描：none()

                    //3、通过正则表达式控制：regex(final String pathRegex)

                    //4、通过ant()控制：ant(final String antPattern)

                //例：.paths(PathSelectors.ant("/controller/**"))

                .paths(PathSelectors.ant("控制类中@RequestMapping中的路径"))

                .build();

    }

    //配置文档信息

    private ApiInfo apiInfo() {

        Contact contact = new Contact("联系人名字", "http://xxx.xxx.com/联系人访问链接", "联系人邮箱");

        return new ApiInfo(

                "Swagger的学习笔记", // 标题

                "如何配置Swagger", // 描述

                "v1.0", // 版本

                "http://terms.service.url/组织链接", // 组织链接

                contact, // 联系人信息

                "Apach 2.0 许可", // 许可

                "许可链接", // 许可连接

                new ArrayList<>()// 扩展

        );

    }

    //配置分组一

    @Bean

    public Docket docket1() {

        return new Docket(DocumentationType.SWAGGER_2).groupName("group1");

    }

    //配置分组二

    @Bean

    public Docket docket2() {

        return new Docket(DocumentationType.SWAGGER_2).groupName("group2");

    }

}