这期内容当中小编将会给大家带来有关SpringBoot中怎么处理校验参数,文章内容丰富且以专业的角度为大家分析和叙述,阅读完这篇文章希望大家可以有所收获。
为石门等地区用户提供了全套网页设计制作服务,及石门网站建设行业解决方案。主营业务为网站设计、做网站、石门网站设计,以传统方式定制建设网站,并提供域名空间备案等一条龙服务,秉承以专业、用心的态度为用户提供真诚的服务。我们深信只要达到每一位用户的要求,就会得到认可,从而选择与我们长期合作。这样,我们也可以走得更远!
什么是Validator
Bean Validation是Java定义的一套基于注解的数据校验规范,目前已经从JSR 303的1.0版本升级到JSR 349的1.1版本,再到JSR 380的2.0版本(2.0完成于2017.08),已经经历了三个版本 。在SpringBoot中已经集成在 starter-web中,所以无需在添加其他依赖。
注解介绍
validator内置注解
注解
详细信息
@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(value)
被注释的元素必须符合指定的正则表达式
Hibernate Validator 附加的 constraint
注解
详细信息
被注释的元素必须是电子邮箱地址
@Length
被注释的字符串的大小必须在指定的范围内
@NotEmpty
被注释的字符串的必须非空
@Range
被注释的元素必须在合适的范围内
@NotBlank
验证字符串非null,且长度必须大于0
注意:
@NotNull 适用于任何类型被注解的元素必须不能与NULL @NotEmpty 适用于String Map或者数组不能为Null且长度必须大于0 @NotBlank 只能用于String上面 不能为null,调用trim()后,长度必须大于0
使用
使用起来也非常简单,下面略过创建项目
模拟用户注册封装了一个UserDTO
当提交数据的时候如果使用以前的做法就是IF ELSE判断参数使用validator则是需要增加注解即可。
例如非空校验:
然后需要在controller方法体添加@Validated不加@Validated校验会不起作用
然后请求一下请求接口,把Email参数设置为空
参数:
{ "userName":"luomengsun", "mobileNo":"11111111111", "sex":1, "age":21, "email":""}
返回结果:
后台抛出异常
这样是能校验成功,但是有个问题就是返回参数并不理想,前端也并不容易处理返回参数,所以我们添加一下全局异常处理,然后添加一下全局统一返回参数这样比较规范。
添加全局异常
创建一个GlobalExceptionHandler类,在类上方添加@RestControllerAdvice注解然后添加以下代码:
/** * 方法参数校验 */@ExceptionHandler(MethodArgumentNotValidException.class)public ReturnVO handleMethodArgumentNotValidException(MethodArgumentNotValidException e) { log.error(e.getMessage(), e); return new ReturnVO().error(e.getBindingResult().getFieldError().getDefaultMessage()); }
此方法主要捕捉MethodArgumentNotValidException异常然后对异常结果进行封装,如果需要在自行添加其他异常处理。
添加完之后我们在看一下运行结果,调用接口返回:
{ "code": "9999", "desc": "邮箱不能为空", "data": null}
OK 已经对异常进行处理。
校验格式
如果想要校验邮箱格式或者手机号的话也非常简单。
校验邮箱
/** * 邮箱 */ @NotBlank(message = "邮箱不能为空") @NotNull(message = "邮箱不能为空") @Email(message = "邮箱格式错误") private String email;
使用正则校验手机号
校验手机号使用正则进行校验,然后限制了一下位数
/** * 手机号 */ @NotNull(message = "手机号不能为空") @NotBlank(message = "手机号不能为空") @Pattern(regexp ="^[1][3,4,5,6,7,8,9][0-9]{9}$", message = "手机号格式有误") @Max(value = 11,message = "手机号只能为{max}位") @Min(value = 11,message = "手机号只能为{min}位") private String mobileNo;
查看一下运行结果
传入参数:
{ "userName":"luomengsun", "mobileNo":"111111a", "sex":1, "age":21, "email":"1212121"}
返回结果:
{ "code": "9999", "desc": "邮箱格式错误", "data": null}
这里不再验证手机号的例子
自定义注解
上面的注解只有这么多,如果有特殊校验的参数我们可以使用Validator自定义注解进行校验
首先创建一个IdCard注解类
@Documented@Target({ElementType.PARAMETER, ElementType.FIELD})@Retention(RetentionPolicy.RUNTIME)@Constraint(validatedBy = IdCardValidator.class)public @interface IdCard { String message() default "身份证号码不合法"; Class>[] groups() default {}; Class extends Payload>[] payload() default {};}
在UserDTO中添加@IdCard注解即可验证,在运行时触发,本文不对自定义注解做过多的解释,下篇文章介绍自定义注解
message 提示信息 groups 分组 payload 针对于Bean
然后添加IdCardValidator 主要进行验证逻辑
上面调用了is18ByteIdCardComplex方法,传入参数就是手机号,验证身份证规则自行百度
然后使用
@NotNull(message = "身份证号不能为空") @IdCard(message = "身份证不合法") private String IdCardNumber;
分组
就比如上面我们定义的UserDTO中的参数如果要服用的话怎么办?
在重新定义一个类然后里面的参数要重新添加注解?
Validator提供了分组方法完美了解决DTO服用问题
现在我们注册的接口修改一下规则,只有用户名不能为空其他参数都不进行校验
先创建分组的接口
public interface Create extends Default {}
我们只需要在注解加入分组参数即可例如:
/** * 用户名 */ @NotBlank(message = "用户姓名不能为空",groups = Create.class) @NotNull(message = "用户姓名不能为空",groups = Create.class) private String userName; @NotBlank(message = "邮箱不能为空",groups = Update.class) @NotNull(message = "邮箱不能为空",groups = Update.class) @Email(message = "邮箱格式错误",groups = Update.class) private String email;
然后在修改Controller在@Validated中传入Create.class
@PostMapping("/user") public ReturnVO userRegistra(@RequestBody @Validated(Create.class) UserDTO userDTO){ ReturnVO returnVO = userService.userRegistra(userDTO); return returnVO ; }
然后调用传入参数:
{ "userName":"",}
返回参数:
{ "code": "9999", "desc": "用户姓名不能为空", "data": null}
OK 现在只对Create的进行校验,而Updata组的不校验,如果需要复用DTO的话可以使用分组校验
校验单个参数
在开发的时候一定遇到过单个参数的情况,在参数前面加上注解即可
@PostMapping("/get") public ReturnVO getUserInfo(@RequestParam("userId") @NotNull(message = "用户ID不能为空") String userId){ return new ReturnVO().success(); }
然后在Controller类上面增加@Validated注解,注意不是增加在参数前面。
上述就是小编为大家分享的SpringBoot中怎么处理校验参数了,如果刚好有类似的疑惑,不妨参照上述分析进行理解。如果想知道更多相关知识,欢迎关注创新互联行业资讯频道。
网站栏目:SpringBoot中怎么处理校验参数
地址分享:http://lswzjz.com/article/pgocio.html