<!-- 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>

package com.hxl.config;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
@Configuration
@EnableSwagger2 //開(kāi)啟swagger2
public class SwaggerConfig {
}

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

private ApiInfo apiInfo(){
    //作者信息
    Contact contact = new Contact("王木木","https://blog.csdn.net/qq_43585922?spm=1000.2115.3001.5343","11@qq.com");
    return new ApiInfo(
        "Swagger筆記", //標(biāo)題
        "沖沖沖", //描述
        "v1.0。0", //版本
        "https://blog.csdn.net/qq_43585922?spm=1000.2115.3001.5343", //組織鏈接
        contact, //聯(lián)系人信息
        "Apach 2.0 許可", //許可
        "許可鏈接", //許可連接
        new ArrayList<>()//擴(kuò)展
    );
}

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

//配置了Swagger的Docket實(shí)例
@Bean
public Docket docket(){
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .select()
        /*
                RequestHandlerSelectors：要掃描接口的方式
                basePackage：指定要掃描的包
                any()：掃描全部
                none()：不掃描
                withClassAnnotation：掃描類(lèi)上的注解，參數(shù)是一個(gè)注解的反射對(duì)象
                withMethodAnnotation：掃描方法上的注解
                path()：過(guò)濾什么路徑
                */
        .apis(RequestHandlerSelectors.basePackage("com.hxl.controller"))
        //.paths(PathSelectors.ant("/hxl/**"))
        .build();
}

@Bean
public Docket docket(){
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        //enable是否啟動(dòng)Swagger，默認(rèn)為true，如果該位false則不能在瀏覽器中訪問(wèn)
        .enable(false)
        .select()
        /*
                RequestHandlerSelectors：要掃描接口的方式
                basePackage：指定要掃描的包
                any()：掃描全部
                none()：不掃描
                withClassAnnotation：掃描類(lèi)上的注解，參數(shù)是一個(gè)注解的反射對(duì)象
                withMethodAnnotation：掃描方法上的注解
                path()：過(guò)濾什么路徑
                */
        .apis(RequestHandlerSelectors.basePackage("com.hxl.controller"))
        //.paths(PathSelectors.ant("/hxl/**"))
        .build();
}

@Bean
public Docket docket(Environment environment){
    //設(shè)置顯示的Swagger環(huán)境
    Profiles profiles = Profiles.of("dev", "test");
    //通過(guò)  判斷是否處在自己設(shè)定的環(huán)境中
    boolean flag = environment.acceptsProfiles(profiles);
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        //這里變成了flag
        .enable(flag)
        .select()     
        .apis(RequestHandlerSelectors.basePackage("com.hxl.controller"))
        .build();
}

@Bean
public Docket docket(Environment environment){
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .groupName("王木木");
    //其余配置省略
}

//其他的環(huán)境需要自己填
@Bean
public Docket docket1(){
    return new Docket(DocumentationType.SWAGGER_2).groupName("天");
}
@Bean
public Docket docket2(){
    return new Docket(DocumentationType.SWAGGER_2).groupName("狼");
}

package com.hxl.pojo;
public class User {
    public String username;
    public String password;
}

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

package com.hxl.pojo;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
//@Api("注釋")
@ApiModel("用戶實(shí)體類(lèi)")
public class User {
    @ApiModelProperty("姓名")
    public String username;
    @ApiModelProperty("密碼")
    public String password;
}

@ApiOperation("王木木的接口")
@PostMapping("/hxl")
public String hxl(@ApiParam("用戶名")String username){
    return username;
}