Controller层接口参数校验统一处理

背景

一般的controller层接口都要做参数校验的，最起码的空判断都是要做的。以前的写法就是一堆 if 判空堆在一起，空了就想改进一下，看看有没有什么更好的方法。然后就查到了有校验注解 @Validated ，在此记录使用方法。

使用

总结来说就是对非空字段用对应注解标记，然后在全局统一异常处理中对参数校验异常统一处理。

POST请求

    @PostMapping("/submit")
    @ApiOperation(value = "提交")
    public MyResult<Void> submit(@Validated @Requestbody User user) {
        //  业务逻辑
    }

@Data
public class User {

    @NotBlank(message = "昵称不允许为空")
    private String name;

    @NotBlank(message = "编号不允许为空")
    private String code;

}

 GET请求

@Validated 要声明在类上

@Validated
@Slf4j
@RestController
@RequestMapping("/user")
@Api(value = "/用户相关接口", description = "用户相关接口")
public class UserController {

    @GetMapping("/submit")
    @ApiOperation(value = "提交")
    public MyResult<Void> submit(@NotBlank(message = "昵称不允许为空") @RequestParam("name") String name, 
                                 @NotBlank(message = "编号不允许为空") @RequestParam("code") String code) {
        //  业务逻辑
    }

}

校验提示统一处理

@RestControllerAdvice
public class GlobalExceptionHandler {

    /**
     * 参数统一校验异常
     * @param e
     * @return
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.OK)
    public MyResult<Void> paramExceptionHandler(MethodArgumentNotValidException e) {
        return new MyResult<>(ResultCodes.PARAMETER_IS_NULL, e.getBindingResult().getFieldError().getDefaultMessage());
    }
}

其他

目前只是简单使用，其他细节可以看看参考链接，大佬写得很详细，对比了好多文章，这篇比较清晰全面，感谢分享～

参考

一起来学SpringBoot（十七）优雅的参数校验