JSR303参数校验使用手记

本文介绍了JSR303参数校验在SpringBoot中的使用,包括快速开始、支持JSON接收参数、统一处理参数异常的策略,以及现身说法展示了@Valid的用法和注解大全。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

参数校验的必要性千篇一律,就不再多言了。

快速开始

1、引入jar包

springboot项目中引入jar包(有了springboot就是好,jsr303直接成了一个starter,不用再去担心版本,jar包不对什么的了)。

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-validation</artifactId>
</dependency>

2、简单的示例

-->构造一个简单的POJO用于接收参数

public class UserVO implements Serializable {

	private static final long serialVersionUID = 1L;

	@NotBlank(message = "name不能为空")
	private String name;
	
	@NotNull(message = "年龄不能为空")
	@Min(value = 18, message = "未成年人禁止访问")
	private Integer age;

    //省略get/set.....
}

-->controller

@Controller
@RequestMapping("/test")
public class TestController {

	/**
	 * <p>jsr303测试
	 * */
	@RequestMapping(value = "/jsr303test")
	@ResponseBody
	public String jsr303Test(@Valid UserVO userVO, BindingResult result) {
		// 参数校验
		if(result.hasErrors()) {
			List<FieldError> errors = result.getFieldErrors();
			Map<String, Object> map = new HashMap<>();
			for(FieldError error : errors) {
				map.put(error.getField(), error.getDefaultMessage());
			}
			return map.toString();
		}
		return "校验通过,处理点其它的业务吧..";
	}

}

-->测试及结果

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

json接收参数同样支持

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

 统一处理参数异常

在上面的示例中,每个控制层方法都需要单独对BindingResult进行处理,既不方便,更不优雅。所以需要统一的对其进行处理。

因为Validator所有的参数异常都是抛出的BindException异常,我们就可以利用异常拦截对其进行统一处理。

1.控制层方法中不再需要声明BindingResult形参;

@Controller
@RequestMapping("/test")
public class TestController {

	/**
	 * <p>jsr303测试
     * <p>这里没有声明BindingResult参数  
	 * */
	@RequestMapping(value = "/jsr303test")
	@ResponseBody
	public String jsr303Test(@Valid UserVO userVO) {
		
		return "校验通过,处理点其它的业务吧..";
	}

}

2.统一异常拦截

/**
 * 全局异常拦截
 * */
@ControllerAdvice
public class GlobalExceptionHandler {

	// org.springframework.validation.BindException;
	@ExceptionHandler(BindException.class)
    @ResponseBody
	public String BindExceptionHandler(HttpServletRequest request, BindException ex) {
		// 注:一旦进入异常拦截,说明一定有参数异常。所以不用再进行ex.hasErrors();判断.直接对BindException进行处理即可。
		System.out.println("=========BindException拦截============");
		List<FieldError> errors = ex.getFieldErrors();
		// 实际应用中,这里用自身项目中的统一返回json对象进行处理
		Map<String, Object> map = new HashMap<>();
		for(FieldError error : errors) {
			map.put(error.getField(), error.getDefaultMessage());
		}
		return map.toString();
	}

}

3.测试结果一样可以进行有效的参数异常拦截,如下:

watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MTM4MTg2Mw==,size_16,color_FFFFFF,t_70

现身说法

1、@Valid只能校验用POJO作为参数接收对象,参数传递方式可以是json;

2、单个参数验证

@NotNull(message = "id不能为空")Long id

3、JSR303的校验结果都封装在接口BindingResult中,BindingResult必须紧跟在被@Valid注解的参数后面(非常建议使用统一异常拦截处理);

反例:

BindingResult没有紧跟在@Valid注解的参数后面;

20190531141951564.png

4、需要校验的POJO属性,可以加入多个校验;

20190531142325691.png

5、建议使用包装类替代基本数据类型,基本数据类型没有注解支持非空判断;

注解大全

注解说明
@Null被注解的属性必须为Null
@NotNull验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格,适用String
@NotEmpty检查约束元素是否为NULL或者是EMPTY,适用集合
@AssertTrue验证 Boolean 对象是否为 true  
@AssertFalse验证 Boolean 对象是否为 false
@Size(min=, max=)验证对象(Array,Collection,Map,String)长度是否在给定的范围之内
@Length被注解的字符串长度
@Past验证 Date 和 Calendar 对象是否在当前时间之前
@Future验证 Date 和 Calendar 对象是否在当前时间之后
@Pattern验证 String 对象是否符合正则表达式的规则
@Min验证 Number 和 String(必须是数字类型) 对象是否大等于指定的值
@Max 验证 Number 和 String(必须是数字类型) 对象是否小等于指定的值
@DecimalMax被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
@DecimalMin被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
@Digits验证 Number 和 String 的构成是否合法  ,示例:@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字,interger指定整数精度,fraction指定小数精度
@Range检查数字是否介于min和max之间
@CreditCardNumber信用卡验证
@Email验证是否是邮件地址,如果为null,不进行验证,算通过验证
@URL判断该值是否是一个有效的URL, 如果给出了约束中的protocol, host 或 port 参数的话,那个被校验的值需要和其匹配

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值