VO 声明验证

在 VO 中使用 javax.validation.constraints 包提供的验证注解：

	@Data
	public class AnchorRecordVO {
	    @NotNull(message = "基站编号不能为空")
	    private Long num;
	
	    @NotNull(message = "天线编号不能为空")
	    private Integer antId;
	
	    private String site;
	
		...
	}

Controller 中使用 @Validated

在请求参数前使用 @Valid 注解就可以完成验证，验证结果将存放到 BindingResult 中。

	@RequestMapping(value = "/anchors", method = RequestMethod.POST)
    @ResponseBody
    public ResultBean addAnchor(@RequestBody @ValidatedAnchorRecordVO vo, BindingResult bindingResult) {
        return new ResultBean(anchorService.save(vo));
    }

使用 ControllerAdvice 统一处理

定义一个异常处理， 使用 @ResponseBody 注解才能返回自定义格式，否则Spring 将包装一个返回结果，并且 HTTP Status 为400

	@ControllerAdvice
	@Slf4j
	public class ControllerExceptionHandler {
	
	    /**
	     * 处理验证异常
	     *
	     * @param request
	     * @param exception
	     * @return
	     */
	    @ExceptionHandler(MethodArgumentNotValidException.class)
	    @ResponseBody
	    public ResultBean handleBindException(HttpServletRequest request, MethodArgumentNotValidException exception) {
	
	        log.error("访问" + request.getRequestURI() + "发生参数验证异常", exception);
	
	        ResultBean<?> result = new ResultBean();
	
	        String messages = exception.getBindingResult().getAllErrors()
	                .stream()
	                .map(ObjectError::getDefaultMessage)
	                .reduce((m1, m2) -> m1 + "，" + m2)
	                .orElse("参数输入有误");
	
	        result.setMsg(messages);
	        result.setCode(FAIL);
	
	        return result;
	    }
	
	    /**
	     * 处理参数类型转换异常
	     *
	     * @param request
	     * @param exception
	     * @return
	     */
	    @ExceptionHandler(InvalidFormatException.class)
	    @ResponseBody
	    public ResultBean handleParseException(HttpServletRequest request, InvalidFormatException exception) {
	
	
	        String messages = String.format("字段 [%s] 的值 [%s] 不能转换成 [%s] 类型", exception.getPathReference(),
	                exception.getValue(), exception.getTargetType().getName());
	
	        log.error("访问" + request.getRequestURI() + "发生参数验证异常 : {}", messages);
	
	        ResultBean<?> result = new ResultBean();
	        result.setMsg("参数类型输入有误");
	        result.setCode(FAIL);
	
	        return result;
	    }
	}

类库说明

1. 注解说明

2. 使用groups的校验

同一个对象要复用，但在不同场景下要求实效不同的校验规则， 如 ID 字段，在新增时不需要验证， 但在更新接口中要求不能为空。

2.1 先定义groups的分组接口

	import javax.validation.groups.Default;
	
	public interface Create extends Default {
	}
	
	import javax.validation.groups.Default;
	
	public interface Update extends Default{
	}

2.2 在验证类校验注解中使用

   @NotNull(message = "id不能为空", groups = Update.class)
   private Long userId;

2.3 Controller 中设置 Groups

    public ResultBean update(@RequestBody @Validated(Update.class) UserVo userVo){
    }

3. 在Controller接口中直接使用

3.1 接口方法中使用验证注解

    public ResultBean getUser(@RequestParam("userId") @NotNull(message = "用户id不能为空") Long userId) {

3.2 Controller 中开启验证

	@RestController
	@RequestMapping("user/")
	@Validated
	public class UserController{ ... }