JSR303数据校验实战

目录

一 点睛

二 实战

三 测试结果

四 常见参数

五 关键源码

---

一 点睛

Springboot中可以用@validated来校验数据，如果数据异常则会统一抛出异常，方便异常中心统一处理。

二 实战

1 配置文件

dog:
  age: 3
  last-name: 大黄

2 代码

package com.example.demo.pojo;


import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import org.springframework.validation.annotation.Validated;


import javax.validation.constraints.Email;


/**
* @className: Dog
* @description: 实体类，演示松散绑定
* @date: 2020/6/9
* @author: cakin
*/
@Component
@Data
@AllArgsConstructor
@NoArgsConstructor
@ConfigurationProperties("dog")
// JSR303注解
@Validated
public class Dog {
    @Email(message = "邮箱错误了")
    private String lastName;
    private Integer age;
}

3 测试代码

package com.example.demo;


import com.example.demo.pojo.Dog;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;


@SpringBootTest
@Slf4j
class DemoApplicationTests {
    @Autowired
    Dog dog;


    @Test
    void contextLoads() {
      try {
         log.info(dog.toString());
      } catch (Exception e) {
         e.printStackTrace();
      }
   }
}

三 测试结果

Description:


Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'dog' to com.example.demo.pojo.Dog failed:


    Property: dog.lastName
    Value: 大黄
    Origin: class path resource [application.yaml]:3:14
    Reason: 邮箱错误了

四 常见参数

@NotNull(message="名字不能为空")
private String userName;
@Max(value=120,message="年龄最大不能查过120")
private int age;
@Email(message="邮箱格式错误")
private String email;


空检查
@Null       验证对象是否为null
@NotNull    验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank   检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty   检查约束元素是否为NULL或者是EMPTY.
    
Booelan检查
@AssertTrue     验证 Boolean 对象是否为 true  
@AssertFalse    验证 Boolean 对象是否为 false  
    
长度检查
@Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内  
@Length(min=, max=) string is between min and max included.


日期检查
@Past       验证 Date 和 Calendar 对象是否在当前时间之前  
@Future     验证 Date 和 Calendar 对象是否在当前时间之后  
@Pattern    验证 String 对象是否符合正则表达式的规则


.......等等
除此以外，我们还可以自定义一些数据校验规则

五 关键源码