<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger2 -->
<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger2</artifactId>
   <version>2.9.2</version>
</dependency>
<!-- https://mvnrepository.com/artifact/io.springfox/springfox-swagger-ui -->
<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger-ui</artifactId>
   <version>2.9.2</version>
</dependency>

@Configuration
@EnableSwagger2        //開(kāi)啟Swagger2
public class SwaggerConfig {
    
}

//配置了Swagger的Docket的bean實(shí)例
    @Bean
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2);
 
    }

    //配置文檔信息
    private ApiInfo apiInfo() {
        Contact contact = new Contact("龍弟", "https://blog.csdn.net/weixin_48838340", "聯(lián)系人郵箱");
        return new ApiInfo(
                "龍弟的Swagger學(xué)習(xí)文檔", // 標(biāo)題
                "學(xué)習(xí)演示如何配置Swagger", // 描述
                "v1.0", // 版本
                "https://blog.csdn.net/weixin_48838340", // 組織鏈接
                contact, // 聯(lián)系人信息
                "Apach 2.0 許可", // 許可
                "許可鏈接", // 許可連接
                new ArrayList<>()// 擴(kuò)展
        );
    }
}

    @Bean
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo());
    }

    //配置了Swagger的Docket的bean實(shí)例
    @Bean
    public Docket docket(){
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()// 通過(guò).select()方法，去配置掃描接口,RequestHandlerSelectors配置如何掃描接口
                  //any() // 掃描所有，項(xiàng)目中的所有接口都會(huì)被掃描到
                 // none() // 不掃描接口
        // withMethodAnnotation通過(guò)方法上的注解掃描，如withMethodAnnotation(GetMapping.class)只掃描get請(qǐng)求
        // 通過(guò)類(lèi)上的注解掃描，如.withClassAnnotation(Controller.class)只掃描有controller注解的類(lèi)中的接口
                .apis(RequestHandlerSelectors.basePackage("com.longdi.swagger.controller"))
                //path()  過(guò)濾什么路徑
                .paths(PathSelectors.ant("/longdi/**"))
                .build();
    };

    @Bean
    public Docket docket() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .enable(false) //配置是否啟用Swagger，如果是false，在瀏覽器將無(wú)法訪問(wèn)
                .select()// 通過(guò).select()方法，去配置掃描接口,RequestHandlerSelectors配置如何掃描接口
                .apis(RequestHandlerSelectors.basePackage("com.longdi.swagger.controller"))
                // 配置如何通過(guò)path過(guò)濾,即這里只掃描請(qǐng)求以/longdi開(kāi)頭的接口
                .paths(PathSelectors.ant("/longdi/**"))
                .build();
    }

    @Bean
    public Docket docket(Environment environment) {
        // 設(shè)置要顯示swagger的環(huán)境
        Profiles of = Profiles.of("dev", "test");
        // 判斷當(dāng)前是否處于該環(huán)境
        // 通過(guò) enable() 接收此參數(shù)判斷是否要顯示
        boolean b = environment.acceptsProfiles(of);
 
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .enable(b) //配置是否啟用Swagger，如果是false，在瀏覽器將無(wú)法訪問(wèn)
                .select()// 通過(guò).select()方法，去配置掃描接口,RequestHandlerSelectors配置如何掃描接口
                .apis(RequestHandlerSelectors.basePackage("com.longdi.swagger.controller"))
                // 配置如何通過(guò)path過(guò)濾,即這里只掃描請(qǐng)求以/longdi開(kāi)頭的接口
                .paths(PathSelectors.ant("/longdi/**"))
                .build();
    }

    @Bean
    public Docket docket1(Environment environment) {
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
                .groupName("A") ;// 配置分組
        // 省略配置....
    }

    //只要我們的接口中，返回值中存在實(shí)體類(lèi)，它就會(huì)被掃描到Swagger中
    @PostMapping(value="/user")
    public User getUser(){
        return new User();
    }

    //Operation接口，不是放在類(lèi)上的，是方法
    @ApiOperation("龍弟的接口")
    @GetMapping("/hello2")
    public String kuang(@ApiParam("這個(gè)名字會(huì)被返回")String username){
        return "hello"+username;
    }