《swagger》 swagger + springboot 传递 对象参数, List,数组参数

时间:2025-03-18 19:23:18

传对象,传list或数组是常遇到的问题.(此处传递对象、数组需要使用@RequestBody 注解进行参数解析)

传递对象参数
    @ApiOperation(value="添加Client", notes="增加Client" )
    @ApiImplicitParam(name = "client", value = "client信息", required = true, dataType = "Client")
    @RequestMapping("/save")
    public Client save(@RequestBody Client client) {
        return (client);
    }

传递List参数
    @ApiOperation(value="添加权限", notes="增加权限" )
    @ApiImplicitParams({ 
        @ApiImplicitParam(name = "clientId", value = "clientId", required = true, paramType = "query",dataType = "String", defaultValue="1"),
      })
    @RequestMapping("/save")
    public Boolean save(String clientId, @RequestParam(value = "powerClientIds") @ApiParam(value = "可被访问的clientId列表") List<String> powerClientIds) {
                ........
        return true;
    }