SpringBoot后端进行数据校验JSR303的使用详解

2023-07-04 14:19:05 77

如果只想查看注解，请跳到文章末尾部分

简介

在前后端进行数据交互中，在前端把数据传送到后端前，一般会先进行校验一次,校验成功之后，才把数据发送到后端。但是我们在服务端还得在对数据进行一次校验。因为请求数据发送的链接很容易获取，可以不经过前端界面，使用postman等工具直接向后台发送数据，这就可能造成发送的数据是不合法的情况。

项目创建

首先创建一个springboot项目

使用的springboot版本为：（本文代码以该版本为准，不同版本springboot，在下面内容会出现一些差异）


org.springframework.boot
spring-boot-starter-parent
2.3.9.RELEASE

引入如下依赖



org.springframework.boot
spring-boot-starter-thymeleaf


org.springframework.boot
spring-boot-starter-web



org.springframework.boot
spring-boot-devtools
runtime
true


org.projectlombok
lombok
true


org.springframework.boot
spring-boot-starter-test
test


org.junit.vintage
junit-vintage-engine




org.springframework.boot
spring-boot-starter-validation

这个作标在新一点的springboot版本中，需要单独引入。在老版本是默认引入的。这个是用来引入对jsr303注解的支持。


org.springframework.boot
spring-boot-starter-validation

接着创建一个JavaBean

packagecn.jxj4869.demo.entity;

importlombok.Data;

importjavax.validation.constraints.NotNull;

@Data
publicclassUser{
@NotNull
privateIntegerid;
privateStringusername;
privateStringpassword;
privateStringemail;
}

返回类型的JavaBean

packagecn.jxj4869.demo.entity;

importjava.util.HashMap;

publicclassRextendsHashMap{
	privatestaticfinallongserialVersionUID=1L;

	publicR(){
		put("code",0);
		put("msg","success");
	}


	publicstaticRerror(intcode,Stringmsg){
		Rr=newR();
		r.put("code",code);
		r.put("msg",msg);
		returnr;
	}

	publicstaticRok(Stringmsg){
		Rr=newR();
		r.put("msg",msg);
		returnr;
	}

	publicRput(Stringkey,Objectvalue){
		super.put(key,value);
		returnthis;
	}
}

创建一个controller。

index方法用来跳转到首页。

packagecn.jxj4869.demo.controller;

importorg.springframework.stereotype.Controller;
importorg.springframework.web.bind.annotation.*;

@Controller
publicclassUserController{

@RequestMapping("/")
publicStringindex(){
return"index";
}
}

首页代码放到resources/templates目录下





Title





新增表单




用户名



密码



邮箱







更新表单





用户名



密码



邮箱

传统的检验方式

要在后端进行数据校验，传统的校验方式在controller层接受数据后，按照要求对数据进行校验

比如要接收一个userbean对象。

现在要对user对象中的username属性进行非空校验，password属性进行非空校验和长度校验。

@PostMapping("/user")
@ResponseBody
publicRuser1(Useruser)throwsException{
if(StringUtils.isEmpty(user.getUsername())){
returnR.error(400,"username不能为空");
}
if(StringUtils.isEmpty(user.getPassword())||user.getPassword().length()>8||user.getPassword().length()<4){
returnR.error(400,"password无效");
}
returnnull;
}

如果有多个方法都需要接受user对象，而且要校验的属性可能不止username和password这两个属性，如果每个方法里面都采用上面这种校验方式的话，代码就会很臃肿，而且不好维护，当改变了userbean的属性，或者对校验规则进行修改后，就得对所有的校验代码进行更新。这是一件工程量很大的事。

使用JSR303

为了解决上述问题，我们可以使用JSR303提供的注解进行校验。

JSR是JavaSpecificationRequests的缩写，意思是Java规范提案。JSR303也就是第303号提案。

使用JSR303的方法很简单，例如上面的需求，我们只需要在user的属性上加上注解即可。

步骤如下：

1、给Bean添加校验注解，一般是在javax.validation.constraints这个包下，也还有一些是hibernate提供的。

2、开启校验功能@Valid。

3、当校验失败的时候，会抛出org.springframework.validation.BindException异常。

常用的校验注解在文末

packagecn.jxj4869.demo.entity;

importlombok.Data;
importorg.hibernate.validator.constraints.Length;

importjavax.validation.constraints.NotNull;

@Data
publicclassUser{

privateIntegerid;
@NotBlank
privateStringusername;
@NotBlank
@Length(min=4,max=8)
privateStringpassword;
privateStringemail;
}

然后在controller里面的方法上，加上@Valid注解即可

@PostMapping("/user2")
@ResponseBody
publicRuser2(@ValidUseruser)throwsException{
System.out.println(user);
returnnull;
}

当校验失败后，会出现如下错误。并且会给出默认的提示信息。

自定义错误信息

那这个错误信息是怎么来的呢。

进入@NotNULL注解的代码里面

@Target({METHOD,FIELD,ANNOTATION_TYPE,CONSTRUCTOR,PARAMETER,TYPE_USE})
@Retention(RUNTIME)
@Repeatable(List.class)
@Documented
@Constraint(validatedBy={})
public@interfaceNotBlank{

	Stringmessage()default"{javax.validation.constraints.NotNull.message}";
	............
............
............
}

会有一个message属性。显然就是指定错误的提示内容。而这些错误提示是在一个叫validationMessages.properties的文件中，用idea的搜索工具可以找到，双击shift键打开搜索。

发现有这么多validationMessages.properties的文件，而且支持国际化。

打开validationMessages_zh.properties,可以看到里面定义了这么多的提示。而错误提示就是从这文件中获取的。

如果我们不想用默认的校验提示信息的话，可以自己指定。

指定message的值即可。

@NotBlank(message="用户名不能为空")
privateStringusername;

错误信息的获取与响应

当校验出错时，会默认返回一个错误界面，或者返回错误提示的json数据。但默认提供的显然不是我们想要的，如果可以拿到错误信息，那我们就能自定义相应数据了。

拿到错误信息的方式也很简单，只要在方法中加上BindingResultresult这个参数，错误信息就会封装这里面。

@PostMapping("/user2")
@ResponseBody
publicRuser2(@ValidUseruser,BindingResultresult)throwsException{
System.out.println(user);
if(result.hasErrors()){//判断是否有错误
Mapmap=newHashMap<>();
//1、获取校验的错误结果
result.getFieldErrors().forEach((item)->{
//FieldError获取到错误提示
Stringmessage=item.getDefaultMessage();
//获取错误的属性的名字
Stringfield=item.getField();
map.put(field,message);
});
returnR.error(400,"提交的数据不合法").put("data",map);
}
//若没有错误，则进行接下去的业务操作。
returnnull;
}

不过不推荐上面这种方式，理由同上，当校验的地方多了，每个方法里面都加上这么个异常处理，会让代码很臃肿。

不知道你们是否还记得，springmvc里面有个全局的异常处理，我们可以自定义一个异常处理，在这里面统一处理异常。

统一处理BinException。这样就可以不用在controller中去处理错误信息了。

packagecn.jxj4869.demo.execption;

importcn.jxj4869.demo.entity.R;
importorg.springframework.validation.BindException;
importorg.springframework.web.bind.annotation.ExceptionHandler;
importorg.springframework.web.bind.annotation.RestControllerAdvice;


importjava.util.HashMap;
importjava.util.Map;

@RestControllerAdvice(basePackages="cn.jxj4869.demo.controller")
publicclassMyExceptionControllerAdvice{

@ExceptionHandler(value=BindException.class)
publicRhandleVaildException(BindExceptione){

Mapmap=newHashMap<>();
//1、获取校验的错误结果
e.getFieldErrors().forEach((item)->{
//FieldError获取到错误提示
Stringmessage=item.getDefaultMessage();
//获取错误的属性的名字
Stringfield=item.getField();
map.put(field,message);
});
returnR.error(400,"提交的数据不合法").put("data",map);

}
}

错误异常类型补充

校验出错的时候，会抛出两种异常

org.springframework.validation.BindException

使用@Valid注解进行校验的时候抛出的

org.springframework.web.bind.MethodArgumentNotValidException

使用@validated校验的时候抛出的

在异常捕获中加入下面这个

@ExceptionHandler(value=MethodArgumentNotValidException.class)
publicRhandleVaildException(MethodArgumentNotValidExceptione){

BindingResultbindingResult=e.getBindingResult();

Mapmap=newHashMap<>();
bindingResult.getFieldErrors().forEach((fieldError)->{
map.put(fieldError.getField(),fieldError.getDefaultMessage());
});
returnR.error(400,"提交的数据不合法").put("data",map);
}

分组校验

在不同业务场景下，校验规则是不一样的，比如user对象中id这个属性，在新增的时候，这个属性是不用填的，要为null，但是在修改的时候，id属性是不能为null的。

可以用注解中的groups属性来指定，在什么场合下使用改注解

@Documented
@Constraint(validatedBy={})
@Target({METHOD,FIELD,ANNOTATION_TYPE,CONSTRUCTOR,PARAMETER,TYPE_USE})
@Retention(RUNTIME)
@Repeatable(List.class)
public@interfaceNotBlank{

	Class[]groups()default{};
	........
}

首先定义两个接口AddGroup和UpdateGroup，不需要做任何实现

packagecn.jxj4869.demo.valid;

publicinterfaceUpdateGroup{
}

packagecn.jxj4869.demo.valid;

publicinterfaceAddGroup{
}

在user中指定group。

id属性在AddGroup的时候，要为null，在UpdateGroup的时候不能为null
username属性在AddGroup和Update的时候，都要进行校验，不能为空。
password属性，当校验的时候指定分组的话，会不起作用，因为没有给它指定校验的分组

packagecn.jxj4869.demo.entity;

importcn.jxj4869.demo.valid.AddGroup;
importcn.jxj4869.demo.valid.UpdateGroup;
importlombok.Data;


importjavax.validation.constraints.NotBlank;
importjavax.validation.constraints.NotEmpty;
importjavax.validation.constraints.NotNull;
importjavax.validation.constraints.Null;


@Data
publicclassUser{

@Null(groups={AddGroup.class})
@NotNull(groups={UpdateGroup.class})
privateIntegerid;


@NotBlank(message="用户名不能为空",groups={AddGroup.class,UpdateGroup.class})
privateStringusername;
@NotEmpty
privateStringpassword;
privateStringemail;
}

在controller中用@Validated注解，指定校验的分组

@PostMapping("/user3")
@ResponseBody
publicRuser3(@Validated(UpdateGroup.class)Useruser){
System.out.println(user);

returnnull;
}

结果如下图所示，因为password属性没有指定校验的分组，所以在校验的时候，都不会对它进行合法性检查。

自定义校验

当提供的注解不能满足我们需求的时候，可以自定义注解。

例如我们现在给user新加一个属性status，并要求这个属性的值只能是0或者1。

新建一个@StatusValue注解。

根据jsr303的规范，校验注解得有三个属性。

message：用来获取错误提示的
groups：指定校验分组的。
payload：可以自定义一些负载信息

使用@Constraint注解指定该注解的校验器

packagecn.jxj4869.demo.valid;

importjavax.validation.Constraint;
importjavax.validation.Payload;
importjava.lang.annotation.Documented;
importjava.lang.annotation.Retention;
importjava.lang.annotation.Target;
importstaticjava.lang.annotation.ElementType.*;
importstaticjava.lang.annotation.ElementType.TYPE_USE;
importstaticjava.lang.annotation.RetentionPolicy.RUNTIME;

@Documented
@Constraint(validatedBy={StatusValueConstraintValidator.class})
@Target({METHOD,FIELD,ANNOTATION_TYPE,CONSTRUCTOR,PARAMETER,TYPE_USE})
@Retention(RUNTIME)
@interfaceStatusValue{
Stringmessage()default"{cn.jxj4869.valid.StatusValue.message}";

Class[]groups()default{};

Class[]payload()default{};

int[]value()default{};
}

自定义校验器

需要实现ConstraintValidator这个接口，第一个泛型是表示要校验哪个注解，第二个泛型是要校验的数据的类型。

initialize是初始化方法
isValid校验方法，判断是否校验成功

packagecn.jxj4869.demo.valid;

importjavax.validation.ConstraintValidator;
importjavax.validation.ConstraintValidatorContext;
importjava.util.HashSet;
importjava.util.Set;

publicclassStatusValueConstraintValidatorimplementsConstraintValidator{

privateSetset=newHashSet<>();
//初始化方法
@Override
publicvoidinitialize(StatusValueconstraintAnnotation){

int[]value=constraintAnnotation.value();
for(intval:value){
set.add(val);
}

}
/**
*判断是否校验成功
*@paramvalue
*@paramcontext
*@return
*/
@Override
publicbooleanisValid(Integervalue,ConstraintValidatorContextcontext){

returnset.contains(value);
}
}

最后在resources目录下添加一个ValidationMessages.properties文件

用来指定错误信息。

cn.jxj4869.valid.StatusValue.message=必须提交指定的值

UserBean

@Data
publicclassUser{

@Null(groups={AddGroup.class})
@NotNull(groups={UpdateGroup.class})
privateIntegerid;


@NotBlank(message="用户名不能为空",groups={AddGroup.class,UpdateGroup.class})
privateStringusername;
@NotEmpty
privateStringpassword;
privateStringemail;

@StatusValue(value={0,1},groups={AddGroup.class,UpdateGroup.class})
privateIntegerstatus;
}

常用注解汇总

注解	功能
@Null	对象必须为null
@NotNull	对象必须不为null，无法检查长度为0的字符串
@NotBlank	字符串必须不为Null，且去掉前后空格长度必须大于0
@NotEmpty	字符串必须非空
@Length(min=1,max=50)	字符串必须在指定长度内
@Range(min=0,max=100)	必须在指定范围内
@AssertTrue	对象必须为true
@AssertFalse	对象必须为false
@Max(Value)	必须为数字，且小于或等于Value
@Min(Value)	必须为数字，且大于或等于Value
@DecimalMax(Value)	必须为数字(BigDecimal)，且小于或等于Value。小数存在精度
@DecimalMin(Value)	必须为数字(BigDecimal)，且大于或等于Value。小数存在精度
@Digits(integer,fraction)	必须为数字(BigDecimal)，integer整数精度，fraction小数精度
@Size(min,max)	对象(Array、Collection、Map、String)长度必须在给定范围
@Email	字符串必须是合法邮件地址
@Past	Date和Calendar对象必须在当前时间之前
@Future	Date和Calendar对象必须在当前时间之后
@Pattern(regexp=“正则”)	字符串满足正则表达式的值

到此这篇关于SpringBoot后端进行数据校验JSR303的使用详解的文章就介绍到这了,更多相关SpringBoot数据校验JSR303的使用内容请搜索毛票票以前的文章或继续浏览下面的相关文章希望大家以后多多支持毛票票！

声明：本文内容来源于网络，版权归原作者所有，内容由互联网用户自发贡献自行上传，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任。如果您发现有涉嫌版权的内容，欢迎发送邮件至：czq8825#qq.com（发邮件时，请将#更换为@）进行举报，并提供相关证据，一经查实，本站将立刻删除涉嫌侵权内容。