1.关于JSR-303
JSR-303规范(Bean Validation规范)提供了对 Java EE 和 Java SE 中的 Java Bean 进行验证的方式。该规范主要使用注解的方式来实现对 Java Bean 的验证功能 。
JSR303属于后端验证
JS属于前端的脚本验证(只作用于客户端的浏览器中,可以被屏蔽)
技术点:正则表达式
直接浏览器地址栏回车、借助于第三方的工具(PostMan)
Hibernate Validator 提供了 JSR 303 规范中所有内置 constraint 的实现,除此之外还有一些附加的 constraint
2.JSR303中含有的注解
@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 |
被注释的元素必须是电子邮箱地址 | |
@Length(min=,max=) | 被注释的字符串的大小必须在指定的范围内 |
@NotEmpty | 被注释的字符串的必须非空 |
@Range(min=,max=,message=) |
被注释的元素必须在合适的范围内 |
注:Hibernate Validator是JSR303的一个参考实现,除了支持所有标准的校验注解外,另外Hibernate Validator还有JSR-380的实现
添加依赖
<dependency>
<groupId>org.hibernate</groupId>
<artifactId>hibernate-validator</artifactId>
<version>6.0.7.Final</version>
</dependency>
基本使用
Model
Controller
在请求处理方法中,使用@Validated或@Valid注解要验证的对象,并根据BindingResult判断校验是否通过
另外,验证参数后必须紧跟BindingResult参数,否则spring会在校验不通过时直接抛出异常
/**
* 书本新增
* 请求路径 SSM/book/editBook
* @param book
* @return
*/
@RequestMapping("/addBook")
public String addBook(@Validated Book book, BindingResult bindingResult){
System.out.println("进入新增方法");
//判断是否验证成功
if(bindingResult.hasErrors()){
System.out.println("验证失败");
//验证失败
return "book/addBook";
}else {
//验证成功
bookService.insert(book);
return "redirect:queryBookPage";
}
}
/**
* @ModelAttribute: 所标记的方法为非请求处理方法,在所有请求方法之前被调用
* @odelAttribute 在所有的@RequestMapping的方法之前被调用!
*
* 作用:数据预加载
* 特点:无返回值
*/
@ModelAttribute
public void init(Model model){
System.out.println("非请求处理方法");
//必须操作
model.addAttribute("book",new Book());
}
注:@Valid和Validated的区别,随便使用哪个都行
@Valid是使用hibernate validation的时候使用
@Validated 是只用spring Validator校验机制使用
页面:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="fmt" uri="http://www.springframework.org/tags/form" %>
<html>
<head>
<%@include file="/common/head.jsp"%>
<title>Title</title>
</head>
<style>
.cl{
color: red;
}
</style>
<body>
<h1>书本新增</h1>
<fmt:form modelAttribute="book" action="${ctx}/book/addBook" method="post">
<label>书本名称:</label><input type="text" name="bookName"><fmt:errors cssClass="cl" path="*"/><br/>
<label>书本价格:</label><input type="text" name="bookPrice"><%--<fmt:errors cssClass="cl" path="bookPrice"/>--%><br/>
<label>书本类型:</label>
<select name="bookType">
<option value="神话">神话</option>
<option value="教育">教育</option>
<option value="文学">文学</option>
<option value="玄幻">玄幻</option>
</select>
<br/>
<input type="submit" value="添加">
</fmt:form>
</body>
</html>
分组验证
Model 定义接口,充当标识、并指定校验的组
// 书本验证分组
public static interface ValidateGroups {
// 新增
public static interface Add {
}
// 修改
public static interface Edit {
}
// 删除
public static interface Del {
}
}
@NotNull(message = "书本编号不能为空",groups = {ValidateGroups.Del.class,ValidateGroups.Edit.class})
private Integer bookId;
@NotBlank(message = "书本信息不能为空!",groups = {ValidateGroups.Add.class,ValidateGroups.Edit.class})
private String bookName;
private String bookNamePinyin;
@NotNull(message = "书本价格不能为空!",groups = {ValidateGroups.Add.class,ValidateGroups.Edit.class})
@Range(min = 80,max = 200,message = "价格必须在80~200之间",groups = {ValidateGroups.Add.class,ValidateGroups.Edit.class})
private Float bookPrice;
Controller
/**
* 书本新增
* 请求路径 SSM/book/editBook
* @param book
* @return
*/
@RequestMapping("/addBook")
public String addBook(@Validated(value = {Book.ValidateGroups.Edit.class}) Book book, BindingResult bindingResult){
System.out.println("进入新增方法");
//判断是否验证成功
if(bindingResult.hasErrors()){
System.out.println("验证失败");
//验证失败
return "book/addBook";
}else {
//验证成功
bookService.insert(book);
return "redirect:queryBookPage";
}
}
组序列
指定组与组之间的检验顺序,如果第一个组校验没过,就不会校验后面的组
@GroupSequence({Default.class,IGroup.Update.class, IGroup.Registry.class})
public interface IGroup {
interface Registry extends Default {}
interface Update extends Default {}
}
在此还有一个自定义注解验证,由于作者未详细学过注解,所有不怎么会关于注解相关的知识,作者立刻就去补给注解相关知识!!!!
至此,JSR303的基本使用介绍完毕,由于作者水平有限难免有疏漏,欢迎留言纠错。