数据校验:有为空、值的取值是否在约定范围、格式是否合法
传统做法使用if-else进行数据校验,这样会使得代码显得臃肿。如何把代码里的一堆if-else参数校验移到其他地方统一处理。这里介绍一种处理此类问题的实用方法。即参数对象内定义好约束条件,通过注解触发校验。
Controller 接口层数据绑定校验
普通使用的 Bean 数据校验工具是hibernate-validator。在Bean类做好校验的约束条件
@Data
public class CreateOrderDTO {
@NotNull(message = "订单号不能为空")
private String orderId;
@NotNull(message = "订单金额不能为空")
@Min(value = 1, message = "订单金额不能小于0")
private Integer amount;
@Pattern(regexp = "^1[3|4|5|7|8][0-9]{9}$", message = "用户手机号不合法")
private String mobileNo;
private String orderType;
private String status;
}
在 Controller 层接口定义中只需要使用@Validated 注解就可以实现自动校验:
@PostMapping("/createOrder")
public CreateOrderBO validationTest(@Validated CreateOrderDTO createOrderDTO) {
return orderServiceImpl.createOrder(createOrderDTO);
}
约束性注解扩展
当我们想校验当前系统特有的限制条件时,例如订单类型枚举限制。我们可以自定义注解来使用
校验工具类
普通的业务方法@Validated 将不能自动校验参数了(因为业务方法以对象级别传递参数而不是参数绑定的方式),需要主动去解析参数对象参数进行校验,这样就要求提供通用的校验工具类来完成
数据合法性校验结果异常统一处理
使用上述方式校验参数合法性抛异常时,可以进行统一的异常封装处理。
总结
按照上述方式处理参数校验,在业务代码里看不到参数校验的内容,所有的校验条件将在bean里面定义约束条件