<dependency>
 <groupId>org.springframework.boot</groupId>
 <artifactId>spring-boot-starter-web</artifactId>
</dependency>

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

/**
 * 集成swagger2 解決前后端分離 弊端：不能及時(shí)協(xié)商+今早解決的問題
 *   使用swagger總結(jié):
 *     通過swagger 給一些比基奧難理解的接口或?qū)傩?，增加注釋信?
 *     接口文檔實(shí)時(shí)更新
 *     可以在線測(cè)試
 *   安全問題:
 *     正式上線的時(shí)候 記得關(guān)閉swagger
 */
@Configuration//加載到springboot配置里面
@EnableSwagger2//開啟swagger2
public class SwaggerConfig {
  /**
   * 配置swagger2
   * 注冊(cè)一個(gè)bean屬性
   * swagger2其實(shí)就是重新寫一個(gè)構(gòu)造器，因?yàn)樗麤]有g(shù)et set方法\
   * enable() 是否啟用swagger false swagger不能再瀏覽器中訪問
   * groupName()配置api文檔的分組 那就注冊(cè)多個(gè)Docket實(shí)例 相當(dāng)于多個(gè)分組
   * @return
   */
  @Bean
  public Docket docket() {
​
    return new Docket(DocumentationType.SWAGGER_2)
        .apiInfo(apiInfo())
        .groupName("XXX")//組名稱
        .enable(true)
        .select()
        /**
         * RequestHandlerSelectors配置掃描接口的方式
         *   basePackage 配置要掃描的包
         *   any 掃描全部
         *   none 不掃描
         *   withClassAnnotation 掃描類上的注解
         *   withMethodAnnotation 掃描方法上的注解
         */
        .apis(RequestHandlerSelectors.basePackage("com.tinygray.madison.controller"))
        /**
         * paths() 掃描過濾方式
         *   any過濾全部
         *   none不過濾
         *   regex正則過濾
         *   ant過濾指定路徑
         */
//        .paths(PathSelectors.ant("/login/**"))
        .build();
  }
​
  /**
   * 配置swagger2信息 =apiInfo
   * @return
   */
  public ApiInfo apiInfo(){
    /*作者信息*/
//    Contact contact = new Contact("XXX", "http://baidu.com", "email");
    Contact contact = new Contact("", "", "");
    return new ApiInfo(
        "XXX的API接口",
        "company接口",
        "V1.0",
        "urn:toVs",
        contact,
        "Apache 2.0",
        "http://www.apache.org/licenses/LICENSE-2.0",
        new ArrayList());
  }
​
}

@Api(tags = "TestController測(cè)試")
@RestController
public class TestController {
  @ApiOperation("login api")
  @GetMapping("/")
  public String login() {
    return "Hello login ~";
  }
​
  @ApiOperation("helloWord Api")
  @GetMapping("/index")
  public String index() {
    return "Hello World ~";
  }
​
  @ApiOperation("admin Api")
  @GetMapping("/admin/hello")
  public String admin() {
    return "hello admin!";
  }
​
  @ApiOperation("user Api")
  @GetMapping("/user/hello")
  public String user() {
    return "hello user";
  }
}