swagger注解主要是用来给swagger生成的接口文档说明用的

1、@Api

使用范围：用在 类上 注解，控制整个类生成接口信息的内容，表示对类的说明，也代表了这个类是swagger2的资源

参数：

tags：说明该类的作用，参数是个数组，可以填多个，在UI视图中就显示几个控制器访问菜单

value：该参数没什么意义，在UI界面上不显示，所以不用配置

description ：用户基本信息操作，已过时，不建议使用

 

2、@ApiModel

使用范围：用于响应实体类上，用于说明实体作用

参数：

value：自定义实体

description：详细描述实体的作用

3、@ApiModelProperty：

使用范围：用在属性上，描述实体类的属性

参数：
name：字段别名
value：字段描述
required：是否是必须字段
example：示例数据
hidden：是否隐藏数据

 

4、@ApiOperation

使用范围：用于方法，表示一个http请求访问该方法的操作

参数：

value：说明方法的用途和作用
notes：方法的注意事项和备注说明
tags：说明该方法的作用，参数是个数组，可以填多个。
格式：tags={"作用1","作用2"}
（在这里建议不使用这个参数，会使界面看上去有点乱，前两个常用）

 

5、@ApiParam

使用范围：用于方法，参数，字段说明 表示对参数的要求和说明

参数：

name：参数别名
value：参数的描述
required： 表示属性是否必填，默认为false

defaultValue：参数默认值

 

6、@ApiIgnore

使用范围：忽略，当前注解描述的方法或类型，不生成api文档

 

7、@ApiImplicitParams

使用范围：使用在方法上，描述方法的一组参数

参数：

value：是@ApiImplicitParam类型的数组

8、@ApiImplicitParam：

使用范围：使用在方法上，描述方法的单个参数

参数：

name：参数名称
value：参数说明
dataType：数据类型
paramType：参数类型

.query 表示参数放在哪里
· header 请求参数的获取：@RequestHeader
· query 请求参数的获取：@RequestParam
· path（用于restful接口） 请求参数的获取：@PathVariable
· body（不常用）
· form（不常用）
defaultValue：参数的默认值
required：true表示参数是否必须传

 

9、@ApiResponses

使用范围：用于请求的方法上，根据响应码表示不同响应

10、@ApiResponse

使用范围：用在请求的方法上，表示不同的响应

参数：

code="404" 表示响应码(int型)，可自定义
message="状态码对应的响应信息"

response：抛出异常的类

 

11、@Profile({"dev", "test"})：

使用范围：用于配置类上，表示只对开发和测试环境有用

12、

@Authorization：声明要在资源或操作上使用的授权方案
@AuthorizationScope：描述OAuth2授权范围
@ResponseHeader：表示可以作为响应的一部分提供的标头
@ApiProperty：描述POJO对象中的属性值
@ApiError：接口错误所返回的信息