本文将全面的介绍如何使用 validator 进行数据校验
本文源码: https://gitee.com/yintianwen7/taven-springboot-learning/tree/master/springboot-validate
我们只需要引入 spring-boot-starter-web
包即可使用
常用注解
public class CardDTO {
@NotBlank
private String cardId;
@Size(min = 10, max = 10)
@NotNull
private String cardNum; // 卡号
@Past
@NotNull
private Date createDate;
@Range(max = 3)
private String cardType;
// 省略get set
}
@RestController
public class UserController {
@PostMapping("simple")
public Object simple(@RequestBody @Valid CardDTO cardDTO) {
return cardDTO;
}
}
3.1 嵌套实体校验
public class UserDTO {
@NotBlank
private String userId;
@NotBlank
private String username;
private String password;
@Valid
private List<CardDTO> cardList;
//省略 get set
}
controller 写法 同上,只是在 UserDTO cardList 属性上标记@Valid 注解 即可。 3.2 List<DTO> 校验
无效示例
如果我们想校验 一个实体List,如上图所示的这种写法是完全不起效的。
我们需要像 嵌套校验 时一样,对 List<CardDTO>
做一层封装
public class ValidList<E> implements List<E> {
@Valid
private List<E> list = new ArrayList<>();
public List<E> getList() {
return list;
}
public void setList(List<E> list) {
this.list = list;
}
// 省略了 实现方法
}
重写实现方法完全使用 this.list.xxx()
Gitee:spring 会将数据封装到我们定义的 list 属性中,又将属性声明了 @Valid 使得 hibernate validator 可以为我们做校验!
3.3 使用 @Validated 分组校验
public interface Insert {
}
public interface Update {
}
定义两个接口
public class GroupCardDTO {
@NotBlank(groups = {Update.class})
private String id;
@NotBlank(groups = {Insert.class})
private String cardNum;
@NotNull(groups = {Insert.class, Update.class})
private Integer cardType;
//省略 get set
}
实体标记的注解中添加 group 属性
@PostMapping("insert_card")
public Object insert_card(@RequestBody @Validated(Insert.class) GroupCardDTO card){
return card;
}
使用 @Validated(xxx.class) 标记参数,完成分组校验!
当 validator 提供的注解无法满足我们的业务需求,可以通过自定义的方式来实现校验。
需求:校验某字符串必须为大写或者小写
public enum CaseMode {
UPPER,
LOWER
}
定义一个枚举类
import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Target( { ElementType.FIELD })
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = CheckCaseValidator.class)
@Documented
public @interface CheckCase {
String message() default "";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
CaseMode value() default CaseMode.LOWER;
}
import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
public class CheckCaseValidator implements ConstraintValidator<CheckCase, String> {
private CaseMode caseMode;
@Override
public void initialize(CheckCase constraintAnnotation) {
this.caseMode = constraintAnnotation.value();
}
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || "".equals(value.trim())) {
return false;
}
switch (this.caseMode) {
case LOWER:
return value.equals(value.toLowerCase());
case UPPER:
return value.equals(value.toUpperCase());
default:
return false;
}
}
}
备注
我们自定义的注解依然支持 @Validated group 分组
本节源码: https://gitee.com/yintianwen7/taven-springboot-learning/tree/master/springboot-validate
本地下载地址:springboot-validate_jb51.rar
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持亿速云。
亿速云「云服务器」,即开即用、新一代英特尔至强铂金CPU、三副本存储NVMe SSD云盘,价格低至29元/月。点击查看>>
免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。