swagger-注解

常用注解

@Api(value = "xxx"):用于类,表示标识这个类是swagger的资源.
	tags–表示说明,如果有多个值，会生成多个list
	value–也是说明，可以使用tags替代
@ApiOperation(value = "忘记密码，返回状态码，成功：200", httpMethod = "POST")：用于方法,表示一个http请求的操作
	value用于方法描述
	notes用于提示内容 
	tags可以重新分组
	httpMethod表示http请求方式
@ApiParam()：用于方法，参数，字段说明，表示对参数的添加元数据（说明或是否必填等） 
	name–参数名 
	value–参数说明 
	required–是否必填
@ApiModel("xxx"):用于类,表示对类进行说明，用于参数用实体类接收 
	value–表示对象名 
	description–描述 
	都可省略 
@ApiModelProperty():用于方法，字段 表示对model属性的说明或者数据操作更改 
	value–字段说明 
	name–重写属性名字 
	dataType–重写属性类型 
	required–是否必填 
	example–举例说明 
	hidden–隐藏
@ApiIgnore()用于类，方法，方法参数表示这个方法或者类被忽略 
@ApiImplicitParam() 用于方法表示单独的请求参数 
@ApiImplicitParams()  用于方法，包含多个 @ApiImplicitParam
	name–参数ming 
	value–参数说明 
	dataType–数据类型 
	paramType–参数类型 
	example–举例说明