先寫點無關的東西,
io.swagger.annotations包下的幾個常用註解:
@Api:用在請求的類上,表示類的說明
eg:@Api(value="無意義的註解,UI界面可以看到",tags="說明類的作用,可以在UI界面看到的註解")
@ApiImplicitParams:用在請求的方法上,表示一組參數說明
eg:@ApiImplicitParams({
@ApiImplicitParam(paramType="參數放在哪個地方(
-
· header --> 請求參數的獲取:@RequestHeader
-
· query --> 請求參數的獲取:@RequestParam
-
· path(用於restful接口)--> 請求參數的獲取:@PathVariable
-
· body(不常用)
-
· form(不常用)
)",name="參數名",value="參數說明",required="參數是否必須傳",dataType="參數類型,默認值String,其他值類型Integer")
@ApiImplicitParam(其他參數1)
@ApiImplicitParam(其他參數2)
})
@ApiOperation:用於請求的方法上,說明方法的用途和作用
eg:@ApiOperation(value="方法的用途和作用",notes="備註")
引用於:https://blog.csdn.net/jiangyu1013/article/details/83107255
@RequestMapping用來將http請求映射到MVC和Rest控制器的處理方法上:
https://www.iteye.com/news/32657/
正題:public和返回值之間的<T>表示這是一個泛型方法,並聲明瞭一個泛型T
eg:public <T> int(returntype) method(){}