Spring Core JSR305非空验证
JSR305是一种规范,利用编辑器例如IDEA来通知是否为空的缺陷,类似JSR303(Bean Validation规范)通过注解的方式。
@SpringBootTest
public static class TestSpringJsr305 {
@Test
public void test(){
testNonNull(null);
}
@NonNull
public static String testNonNull(@NonNull String name){
return null;
}
}
idea提示如下:
Lombok 非空验证
lombok中的@NonNull不仅在代码编辑器中可以检查null,还会在运行中抛出异常。
@SpringBootTest
public static class TestLombok {
@Test
public void test(){
testNonNull(null);
}
public static void testNonNull(@lombok.NonNull String name){
System.out.println(name);
}
}
打印如下:
java.lang.NullPointerException: name is marked non-null but is null
at com.terry.test.TestNull$TestLombok.testNonNull(TestNull.java:43)
Spring Mvc JSR 303 非空校验
JSR 303(Bean Validation) 是Java EE 6中的一项规范。Hibernate Validator是JSR303中的实现。平时校验表单参数,写判断会比较冗余,使用注解可以更加简洁,并且易于维护。
JSR 303 中的注解
@Null 被注释的元素必须为 null
@NotNull 被注释的元素必须不为 null
@AssertTrue 被注释的元素必须为 true
@AssertFalse 被注释的元素必须为 false
@Min(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@DecimalMax(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@Size(max=, min=) 被注释的元素的大小必须在指定的范围内
@Digits (integer, fraction) 被注释的元素必须是一个数字,其值必须在可接受的范围内
@Past 被注释的元素必须是一个过去的日期
@Future 被注释的元素必须是一个将来的日期
@Pattern(regex=,flag=) 被注释的元素必须符合指定的正则表达式
Hibernate Validator 附加的注解
@NotBlank(message =) 验证字符串非null,且长度必须大于0
@Email 被注释的元素必须是电子邮箱地址
@Length(min=,max=) 被注释的字符串的大小必须在指定的范围内
@NotEmpty 被注释的字符串的必须非空
@Range(min=,max=,message=) 被注释的元素必须在合适的范围内
导入依赖
springboot 对jsr303 封装了starter spring-boot-starter-validation
,实际上底层引入了hibernate-validator
。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-validation</artifactId>
</dependency>
Controller
@RestController
public class TestController {
@Data
public static class User {
@NotNull(message = "名称不能为空")
private String name;
private Integer age;
}
@RequestMapping("/add")
public String add (@Validated @RequestBody User user, BindingResult bindingResult){
if (bindingResult.hasErrors()) {
// 返回第一个错误
List<ObjectError> allErrors = bindingResult.getAllErrors();
return allErrors.get(0).getDefaultMessage();
}
return "添加成功!";
}
}