swagger註解說明

　　 1、與模型相關的註解,用在bean上面

　　　　@ApiModel：用在bean上，對模型類做註釋；

　　　　@ApiModelProperty：用在屬性上，對屬性做註釋

　　2、與接口相關的註解

　　　　@Api：用在controller上，對controller進行註釋；

　　　　@ApiOperation：用在API方法上，對該API做註釋，說明API的作用；

　　　　@ApiImplicitParams：用來包含API的一組參數註解，可以簡單的理解為參數註解的集合聲明；

　　　　@ApiImplicitParam：用在@ApiImplicitParams註解中，也可以單獨使用，說明一個請求參數的各個方面，該註解包含的常用選項有：

　　　　　　paramType：參數所放置的地方，包含query、header、path、body以及form，最常用的是前四個。

　　　　　　name：參數名；

　　　　　　dataType：參數類型，可以是基礎數據類型，也可以是一個class；

　　　　　　required：參數是否必須傳；

　　　　　　value：參數的註釋，說明參數的意義；

　　　　　　defaultValue：參數的默認值；

　　　 @ApiResponses：通常用來包含接口的一組響應註解，可以簡單的理解為響應註解的集合聲明；

　　　 @ApiResponse：用在@ApiResponses中，一般用於表達一個響應信息

　　　　　　code：即httpCode，例如400

　　　　　　message：信息，例如"操作成功"

　　　　　　response = UserVo.class 這裏UserVo是一個配置了@ApiModel註解的對像，該是對像屬性已配置 @ApiModelProperty,swagger可以通過這些配置，生　成接口返回值

代碼例子:

    @ApiOperation(value="獲取用戶詳細信息", notes="根據url的id來獲取用戶詳細信息")
    @ApiImplicitParam(paramType="path", name = "id", value = "用戶ID", required = true, dataType = "Long")
    @RequestMapping(value="/{id}", method=RequestMethod.GET)
    public User getUser(@PathVariable Long id) {
        return users.get(id);
    }
 

網上好多例子都沒有paramType這個參數，導致獲取不到URL的參數，特意記錄一下

詳細的註解說明

• @Api：用在類上，說明該類的作用
• @ApiOperation：用在方法上，說明方法的作用
• @ApiImplicitParams：用在方法上包含一組參數說明
• @ApiImplicitParam：用在@ApiImplicitParams註解中，指定一個請求參數的各個方面
  • paramType：參數放在哪個地方
    • header-->請求參數的獲取：@RequestHeader
    • query-->請求參數的獲取：@RequestParam
    • path（用於restful接口）-->請求參數的獲取：@PathVariable
    • body（不常用）
    • form（不常用）
  • name：參數名
  • dataType：參數類型
  • required：參數是否必須傳
  • value：參數的意思
  • defaultValue：參數的默認值
• @ApiResponses：用於表示一組響應
• @ApiResponse：用在@ApiResponses中，一般用於表達一個錯誤的響應信息
  • code：數字，例如400
  • message：信息，例如"請求參數沒填好"
  • response：拋出異常的類
• @ApiModel：描述一個Model的信息（這種一般用在post創建的時候，使用@RequestBody這樣的場景，請求參數無法使用@ApiImplicitParam註解進行描述的時候）
  • @ApiModelProperty：描述一個model的屬性

Swagger註解