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

@RestController
public class HelloController {

   @RequestMapping(value = "/hello")
    public String Hello(){
        return "Hello Swgger!";
    }

}

@Configuration //配置類
@EnableSwagger2// 開啟Swagger2的自動(dòng)配置
public class SwaggerConfig {  
}

@Configuration
@EnableSwagger2 // 開啟Swagger2的自動(dòng)配置
public class SwaggerConfig {
    //配置了Swagger的Docket的bean實(shí)例
    @Bean
    public Docket docket(Environment environment){
      return new Docket(DocumentationType.SWAGGER_2);
        
}

package com.kk.swagger.config;


import com.kk.swagger.controller.HelloController;
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 org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
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 // 開啟Swagger2的自動(dòng)配置
public class SwaggerConfig {


    //分組
    @Bean
    public Docket docket1(){
        return new Docket(DocumentationType.SWAGGER_2).groupName("KK1");
    }

    @Bean
    public Docket docket2(){
        return new Docket(DocumentationType.SWAGGER_2).groupName("KK2");
    }

    @Bean
    public Docket docket3(){
        return new Docket(DocumentationType.SWAGGER_2).groupName("KK3");
    }



    //配置了Swagger的Docket的bean實(shí)例
    //enable 是否啟動(dòng)Swagger 如果為false 則Swagger 不能再瀏覽器中訪問(wèn)
    @Bean
    public Docket docket(Environment environment){

        //設(shè)置要顯示Swagger的環(huán)境
        Profiles profiles=Profiles.of("dev","test");
        //獲取項(xiàng)目的環(huán)境  通過(guò)environment.acceptsProfiles判斷是否處在自己的設(shè)定的環(huán)境當(dāng)中
        boolean flag = environment.acceptsProfiles(profiles);


        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("kk")
                .enable(flag)
                .select()
                //RequestHandlerSelectors 配置要掃描接口的方式
                //basePackage 指定要掃描的包
                //any()  掃描全部
                //none()  都不掃描
                //withClassAnnotation 掃描方法上的注解  參數(shù)是一個(gè)注解的反射對(duì)象
            
                .apis(RequestHandlerSelectors.basePackage("com.kk.swagger.controller"))
//                .apis(RequestHandlerSelectors.withClassAnnotation(RestController.class)) 這個(gè)只會(huì)掃描類上有RestController的方法
            
                //  .paths() 過(guò)濾什么路徑
//                .paths(PathSelectors.ant("/kk/**"))
            
                .build();
    }
    private static final Contact DEFAULT_CONTACT =new Contact("KK","HTTP","666@qq.com");
    //配置Swagger信息  apiInfo
    private ApiInfo apiInfo(){
        return new ApiInfo("KK的SwaggerAPI文檔", "Api Documentation",
                "1.0", "urn:tos", DEFAULT_CONTACT,
                "Apache 2.0",
                "http://www.apache.org/licenses/LICENSE-2.0", new ArrayList());
    }



}

# 應(yīng)用名稱
spring.application.name=swagger-springboot
# 應(yīng)用服務(wù) WEB 訪問(wèn)端口
server.port=8080
spring.profiles.active=dev

package com.kk.swagger.pojo;


import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
//@Api（注釋）
@ApiModel("用戶實(shí)體類")
public class User {

    @ApiModelProperty("用戶名")
    public String username;
    @ApiModelProperty("密碼")
    public String password;
}

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

//Operation 接口  不是放在類上的  而是放在方法上的
@ApiOperation("Hello控制類,Post測(cè)試")
@PostMapping(value = "/postt")
public User postt(@ApiParam("用戶名") User user){
  return user;
}

<!--        換膚-->
        <!-- https://mvnrepository.com/artifact/com.github.xiaoymin/swagger-bootstrap-ui -->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>swagger-bootstrap-ui</artifactId>
            <version>1.9.6</version>
        </dependency>