一、事有起因
我们在与前端交互的时候,一般会遇到字段格式校验及非空非null的校验,在没有SpringBoot注解的时候,
我们可能会在service进行处理:
if(null == name){
throw new BizException("-1", "用户名不能用空");
}
要是有20个字段需要插入,那我们岂不需要书写20遍这样的代码,当然这种事最直接的解决方式,但作为程序员,我们
首要的任务是要能完成需求到代码的转化,同时还要不断思考如何更加丝滑的写代码,不要重复造轮子。在进入正题之前我们
先认识以下3位老朋友:
entity | 用于抽象数据库中的字段,不断任何处理 |
dto/vo/bean | 作为前端数据与数据库的桥梁,一般我们是一个接口,一个dto,我们的判空也是需要结合dto处理 |
controller | 用于接受前端的请求,我们的判空也是在controller层进行的 |
就此我们正式的开始探索Valid与Validated的旅程
二、判空逻辑的具体实现
2.1、使用的包及注解
2.2、注解的含义
@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=) 被注释的元素必须在合适的范围内
2.3、dto上使用具体需要判断的注解
@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
public class SiteProjectCreateReq implements Serializable {
private static final long serialVersionUID=1L;
@NotEmpty(message = "项目类型不能为空") //一旦为空就用抛出异常,我们统一异常处理就会拦截,然后将message信息给前端
private String type;
}
2.4、controller使用@Valid开启注解
public interface SiteProjectApi {
//如果是集合或者其他数据结构,则需要在接口或者类上加@Validated
@PostMapping(value = "/createProject")
SResponseBean createProject(@RequestBody @Validated SRequestBean<List<SiteProjectCreateReq>> createReqs);
//如果入参是entity,那我们加上@Valid即可,dto中注解就可以生效
@PostMapping(value
= "/createProject")
SResponseBean createProject2(@RequestBody @Valid SiteProjectCreateReq createReqs);
}
@Data
public class SRequestBean<T> implements Serializable {
@Valid
CommonHeaderReq header;
@Valid
T body;
}
/**
* Validated 加在类或者接口上
* Valid 加在具体的entity或者dto
@validated和@valid都可以用在controller层的参数前面,但这只能在controller层生效。
*/
2.5、当不满足条件时,获取错误信息返回
注意:不同的注解,抛出的异常可能不一样,获取方式也不一样,可以调试加上拦截
@RestControllerAdvice()
public class SiteExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public Object handleException(HttpServletRequest request, MethodArgumentNotValidException e){
LoggerUtil.error("出现异常======> [{}] ",e);
//此处获取
@NotEmpty(message = "项目类型不能为空"),中的message
String message = e.getBindingResult().getAllErrors().stream().findFirst().get().getDefaultMessage();
return SResponseUtil.output("01", message); }
}
2.6、再说一句
一般我们拿到需求,产品经理会根据需求,形成原型。前端设计界面,后台设计数据库。
针对于非空字段,一般需要做以下几点:
1、前端在发往后端的时候会进行一次拦截。
2、后端controller进行拦截一次。
3、生成的swaager文档,需要标明必输。
4、数据库设计,需要设计成非空。
三、偷得浮生一刻闲
3.1、新鲜事
网传阿里P9员工出轨P7已婚女下属🤣
3.2、歌曲推荐
童年,这首歌相信大家都很熟悉,小时候那份童真每每想起,嘴角总会上扬,这首粤语版,不失另一种韵味。
3.3、影视推荐
2001太空漫游 2001: A Space Odyssey (1968),我个人始终相信人类是渺小的,宇宙若只有人类,岂不白白浪费。
保持敬畏,保持探索精神。
推荐理由,标新立异,伟大的科幻片。
3.4、养眼壁纸
来源:oschina
链接:https://my.oschina.net/u/4258425/blog/4348256