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

@Configuration
@EnableSwagger2
public class Swagger {
   //創(chuàng)建 Docket 的Bean
   @Bean
   public Docket docket(){
       return new Docket(DocumentationType.SWAGGER_2)
         .apiInfo(apiInfo())
         //select() 函數(shù)返回一個 ApiSelectorBuilder實例用來控制哪些接口暴露給 Swagger 來展現(xiàn)
         .select()
         //要掃描的包
         .apis(RequestHandlerSelectors.basePackage("com.example.controller"))
  //選擇API路徑
         .paths(PathSelectors.any())
         .build();
   }
​  //創(chuàng)建文檔的基本信息
   public ApiInfo apiInfo(){
       return new ApiInfoBuilder()
         .title("Swagger UI 的標題")
         .description("用restful風(fēng)格寫接口")
         .termsOfServiceUrl("")
         .version("1.0")
         .build();
   }
}

@Api(value = "Swagger Test Control", 
     description = "演示Swagger用法的Control類", 
     tags = "Swagger Test Control Tag")

@ApiOperation(
value="創(chuàng)建用戶", 
notes="根據(jù)User對象創(chuàng)建用戶")

@ApiImplicitParams：用在請求的方法上，包含一組參數(shù)說明
    @ApiImplicitParam：對單個參數(shù)的說明      
        name：參數(shù)名
        value：參數(shù)的漢字說明、解釋
        required：參數(shù)是否必須傳
        paramType：參數(shù)放在哪個地方
            · header --> 請求參數(shù)的獲?。篅RequestHeader
            · query --> 請求參數(shù)的獲?。篅RequestParam
            · path（用于restful接口）--> 請求參數(shù)的獲取：@PathVariable
            · body（請求體）-->  @RequestBody User user
            · form（普通表單提交）     
        dataType：參數(shù)類型，默認String，其它值dataType="int"       
        defaultValue：參數(shù)的默認值
--------------------------------------------------------------------
@ApiImplicitParams({
    @ApiImplicitParam(name = "id", value = "ID", dataType = "Long"),
    @ApiImplicitParam(name = "user", value = "用戶", dataType = "User")
})

@ApiResponses：方法返回對象的說明
    @ApiResponse：每個參數(shù)的說明
        code：數(shù)字，例如400
        message：信息，例如"請求參數(shù)沒填好"
        response：拋出異常的類
-------------------------------------------------------------------
@ApiResponses({
    @ApiResponse(code = 400, message = "權(quán)限不足"),
    @ApiResponse(code = 500, message = "服務(wù)器內(nèi)部異常") }
)

@ApiModel( description = "學(xué)生")
public class Student {
    @ApiModelProperty(value = "主鍵id")
    private String id;
    @ApiModelProperty(value = "名稱", required = true)
    private String name;
    @ApiModelProperty(value = "年齡", required = true)
    private int age;
}