SpringMVC： @Valid 表单验证

冷不防 2021-10-01 12:14 365阅读 0赞

## 使用例子 ##

*  Spring Boot 提供了强大的表单验证功能实现

> 假设我们有一个 Student 实体类

@Entity
    @Table(name = "Student")
    @Data
    public class Student {
        @Id
        @GeneratedValue
        private Integer id;
    
        @NotEmpty(message = "姓名不能为空！")
        @Column(length = 50)
        private String name;
    
        @NotNull(message = "年龄不能为空！")
        @Min(value = 18, message = "年龄必须大于18岁！")
        @Column(length = 50)
        private Integer age;
    }

> Dao 接口

public interface StudentRepository extends JpaRepository<Student,Integer> {}
          ○ Service 接口：
    public interface StudentService {
        void add(Student student);
    }

> Service 接口实现类

@Service
    public class StudentServiceImpl implements StudentService {
    
        @Autowired
        private StudentRepository studentRepository;
    
        @Override
        public void add(Student student) {
            studentRepository.save(student);
        }
    }

> Controller

@RestController
    @RequestMapping("/student")
    public class StudentController {
        @Autowired
        private StudentService studentService;
    
        @PostMapping(value="/add")
        public String add(@Valid Student student, BindingResult bindingResult){
            if(bindingResult.hasErrors()){
                return bindingResult.getFieldError().getDefaultMessage();
            }else{
                studentService.add(student);
                return "添加成功！";
            }
        }
    }

*  **@Valid** 与 **BindingResult**
    
     *  @Valid 注解在参数上，表示让 Spring 验证该参数的属性
     *  @Valid 参数后紧跟着一个 BindingResult 参数，用于获取校验结果，否则 Spring 会在校验不通过时抛出异常

## 校验注解 ##

### 空检查 ###

*  **@Null**：限制只能为 null
 *  **@NotNull**：限制不能为 null
 *  **@NotEmpty**：不为 null 且不为空（字符串长度不为0、集合大小不为0）
 *  **@NotBlank**：不为空（不为 null、去除首位空格后的长度为0，与@NotEmpty不同的是字符串比较时会去除字符串的空格）

### Boolean检查 ###

*  **@AssertFalse**：限制必须为false
 *  **@AssertTrue**：限制必须为true

### 长度检查 ###

*  **@Size（max，min）**：限制长度必须在 min 到 max 之间
 *  **@Length(min=,max=)**：长度在 min 到 max 之间

### 日期检查 ###

*  **@Past**：验证注解的元素值（日期类型）比当前时间早
 *  **@Future**：限制必须为一个将来的日期
 *  **@Pattern（value）**：限制必须符合制定的正则表达式

### 数值检查 ###

*  **@Max（value）**：限制必须为一个大于指定值的数字
 *  **@Min（value）**：限制必须为一个小于指定值的数字
 *  **@DecimalMax（value）**：限制必须为一个大于指定值的数字
 *  **@DecimalMin（value）**：限制必须为一个小于指定值的数字
 *  **@Range(min=, max=)** ：数值在 min 到 max 之间
 *  **@Digits（integer，fraction）**：限制必须为一个小数，整数部分位数不能超过integer，小数部分不能超过 fraction

### 其它检查 ###

*  **@Email**：验证元素的值时Email
 *  **@URL(protocol=,host=, port=,regexp=, flags=)**：请求地址、端口、主机检查