swagger中参数为数组dataType的设置

1. Swagge 接口参数:

@ApiImplicitParams({
        @ApiImplicitParam(name = "id", value = "项目ID", dataType = "String", paramType = "query", required = true),
        @ApiImplicitParam(name = "useridlist", value = "用户ID数组", dataType = "String", paramType = "body", allowMultiple = true, required = true ),
        @ApiImplicitParam(name = "Authorization", value = "身份验证Token", dataType = "String", paramType = "header"),
})
allowMultiple=true————表示是数组格式的参数 
dataType="body"————表示数组中参数的类型

dataType="String" 代表请求参数类型为String类型,当然也可以是Map、User、int等;
paramType="body" 代表参数应该放在请求的什么地方:

    header-->放在请求头。请求参数的获取:@RequestHeader(代码中接收注解)
    query -->用于get请求的参数拼接。请求参数的获取:@RequestParam(代码中接收注解)
    path  -->(用于restful接口)-->请求参数的获取:@PathVariable(代码中接收注解)
    body  -->放在请求体。请求参数的获取:@RequestBody(代码中接收注解)
    form  -->(不常用)

2. 界面效果:

3. swagger 传参:

list数组:

List : ["string","string","string"]

4. 接收参数

    header-->放在请求头。请求参数的获取:@RequestHeader(代码中接收注解)
    query-->用于get请求的参数拼接。请求参数的获取:@RequestParam(代码中接收注解)
    path(用于restful接口)-->请求参数的获取:@PathVariable(代码中接收注解)
    body-->放在请求体。请求参数的获取:@RequestBody(代码中接收注解)
    form(不常用)

     @RequestHeader(required = false): 解决不传参数时接口报错的问题
经验分享 程序员 微信小程序 职场和发展