spring接口文檔注解：@ApiOperation

@ApiOperation不是spring自帶的注解是swagger裡的 

com.wordnik.swagger.annotations.ApiOperation;

@ApiOperation和@ApiParam為添加的API相關注解，個參數說明如下： 

@ApiOperation(value = “接口說明”, httpMethod = “接口請求方式”, response = “接口傳回參數類型”, notes = “接口釋出說明”；其他參數可參考源碼； 

@ApiParam(required = “是否必須參數”, name = “參數名稱”, value = “參數具體描述”

實際項目中非常需要寫文檔，提高Java服務端和Web前端以及移動端的對接效率。

Swagger是目前最好用的Restful API文檔生成的開源項目，通過swagger-spring項目

實作了與SpingMVC架構的無縫內建功能，友善生成spring restful風格的接口文檔，

同時swagger-ui還可以測試spring restful風格的接口功能。