Swagger2常用注解说明，2021最新Java面试笔试

@ApiOperation(value = "分页查询用户列表")

@ApiImplicitParams({

        @ApiImplicitParam(name = "pageNum", value = "当前页数"),

        @ApiImplicitParam(name = "pageSize", value = "每页记录数")

})

public List<UserDTO> page(

        @RequestParam(defaultValue = "1", required = false) Integer pageNum, @RequestParam(defaultValue = "10", required = false) Integer pageSize) {

    return list;

}



@GetMapping("/{userId}")

@ApiOperation(value = "根据用户id查询用户")

public UserDTO get(@PathVariable("userId") Integer userId) {

    for (UserDTO userDTO : list) {

        if (userDTO.getUserId().equals(userId)) {

            return userDTO;

        }

    }

    return new UserDTO();

}



@PostMapping

@ApiOperation(value = "新增用户")

public Boolean insert(@RequestBody @ApiParam(name = "UserDTO", value = "新增用户参数") UserDTO userDTO) {

    list.add(userDTO);

    return true;

}



@DeleteMapping("/{userId}")

@ApiOperation(value = "根据用户id删除用户")

public Boolean delete(@PathVariable("userId") Integer userId) {

    Iterator<UserDTO> iterator = list.iterator();

    while (iterator.hasNext()) {

        if (iterator.next().getUserId().equals(userId)) {

            iterator.remove();

            return true;

        }

    }

    return false;

}



@PutMapping

@ApiOperation(value = "更新用户信息")

@ApiResponses({

        @ApiResponse(code = 400, message = "请求参数没填好"),

        @ApiResponse(code = 404, message = "请求路径没有或页面跳转路径不对")

})

public Boolean update(@RequestBody @ApiParam(name = "UserDTO", value = "更新用户参数") UserDTO userDTO) {

    Iterator<UserDTO> iterator = list.iterator();

    while (iterator.hasNext()) {

        UserDTO next = iterator.next();

        if (next.getUserId().equals(userDTO.getUs