文章10 | 阅读 5502 | 点赞0
在 Rest 接口方法上使用来指定请求参数
在 Rest 接口方法上使用来指定请求参数
属性名称 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
value | ApiImplicitParam[] | API 可用的参数列表 |
@ApiImplicitParam 在 Rest 接口上单独使用的时候,表示单个请求参数
@ApiImplicitParam 在 Rest 接口上和 @ApiImplicitParams 组合时候,表示多个请求参数
表示 Rest 接口的单个请求参数,可与 @ApiImplicitParams 组合使用来表示多个请求参数
属性名称 | 数据类型 | 默认值 | 说明 |
---|---|---|---|
name | String | “” | 参数名称(实体类字段名称) |
value | String | “” | 参数简要说明 |
defaultValue | String | “” | 描述参数的默认值 |
allowableValues | String | “” | 限制此参数接收的值,可使用的值或值得范围 |
required | boolean | false | 指定是否为必填参数,false:非必传参数; true:必传参数 |
access | String | “” | 参数过滤,参考: io.swagger.core.filter.SwaggerSpecFilte |
allowMultiple | boolean | false | 指定参数是否可以通过多次出现来接收多个值 |
dataType | String | “” | 参数的数据类型,可以使类名或原始数据类型 |
dataTypeClass | Class<?> | Void.class | 参数的类,如果提供则覆盖 dataType |
paramType | String | “” | 参数的参数类型,有效值为 path, query, body, header, form |
example | String | “” | 非请求体(body)参数的单个请求示例 |
examples | Example | @Example(value = @ExampleProperty(mediaType = “”, value = “”)) | 参数示例,仅适用于 BodyParameters(请求体类型的) |
type | String | “” | 添加覆盖检测到的类型的功能 |
format | String | “” | 添加提供自定义格式的功能 |
allowEmptyValue | boolean | false | 添加将 format 设置为空的功能 |
readOnly | boolean | false | 添加被指定为只读的能力 |
collectionFormat | String | “” | 添加使用 array 类型 collectionFormat 的功能 |
版权说明 : 本文为转载文章, 版权归原作者所有 版权申明
原文链接 : https://blog.csdn.net/dejunyang/article/details/89527376
内容来源于网络,如有侵权,请联系作者删除!