Swagger之@ApiImplicitParam的使用

@ApiImplicitParam该注解可替代另一个@ApiParam，用于统一对Spring MVC的参数进行定义。以下是该注解的参数：属性名称数据类型默认值说明nameString“”参数名称，参数名称将从 filed/method/parameter 名称中派生，但你可以覆盖它，路径参数必须始终命名为它们所代表的路径部分valueString“”参数简单描述defaultValueStrin

养-乐多

4012人浏览 · 2021-02-18 13:00:28

养-乐多 · 2021-02-18 13:00:28 发布

@ApiImplicitParam

该注解可替代另一个@ApiParam，用于统一对Spring MVC的参数进行定义。

以下是该注解的参数：

属性名称	数据类型	默认值	说明
name	String	“”	参数名称，参数名称将从 filed/method/parameter 名称中派生，但你可以覆盖它，路径参数必须始终命名为它们所代表的路径部分
value	String	“”	参数简单描述
defaultValue	String	“”	描述参数默认值
allowableValues	String	“”	可接收参数值限制，有三种方式,取值列表，取值范围
required	boolean	false	是否为必传参数, false:非必传; true:必传
access	String	“”	参数过滤，请参阅:io.swagger.core.filter.SwaggerSpecFilter
allowMultiple	boolean	false	指定参数是否可以通过多次出现来接收多个值
paramType	String	“”	用于定义多种参数类型，如path（路径）、query（查询参数）、body（请求体）、header（请求头）、form（表单）
example	String	“”	非请求体(body)类型的单个参数示例
examples	Example	@Example(value = @ExampleProperty(mediaType = “”, value = “”))	参数示例，仅适用于请求体类型的请求
type	String	“”	添加覆盖检测到类型的功能
format	String	“”	添加提供自定义format格式的功能
allowEmptyValue	boolean	false	添加将格式设置为空的功能
readOnly	boolean	false	添加被指定为只读的能力
collectionFormat	String	“”	添加使用 array 类型覆盖 collectionFormat 的功能