1. JSR303
JSR303是Java为Bean数据合法性校验提供给的标准框架,已经包含在 JavaEE6.0中,JSR303通过在Bean 属性中标注类似 @NotNull @Max 等标准的注解指定校验规则,并通过标准的验证接口对 Bean进行验证。
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
@Email 被注释的元素必须是电子邮箱地址
@Length(min=,max=) 被注释的字符串的大小必须在指定的范围内
@NotEmpty 被注释的字符串的必须非空
@Range(min=,max=,message=) 被注释的元素必须在合适的范围内
注:HIbernate Validator是JSR303的一个参考实现,除了支持所有标准的校验注解外,另外HIbernate Validator还有JSR-380的实现
3.开发示例
实体类中添加验证规则
@Data
public class Book {
public static interface Add{};
public static interface Edit{};
@NotNull(message = "书本id不能为空",groups = Edit.class)
private Integer bid;
@NotBlank(message = "书名不能为空",groups = {Add.class,Edit.class})
private String bname;
@Min(value = 0,message = "价格必须大于零", groups = {Add.class,Edit.class})
private BigDecimal price;
@NotEmpty(message = "书本类型不能为空",groups = {Add.class,Edit.class})
private String type;
private String fileId;
}
到Controller包中添加测试方法
我们选择增加的方法
@Controller
public class BookController {
@Autowired
private IBookService bookService;
/**
* 打开增加界面
* @param model model对象传值
* @return 跳转的界面
*/
@RequestMapping("/openadd")
public String openadd(Model model){
//注意这里必须要往前台数据传入一个空对象
model.addAttribute("book",new Book());
return "book/addBook";
}
/**
* 增加方法
* @param book 实体类对象
* @param bindingResult BindingResult 教程展示了如何使用 BindingResult 来获取验证结果。
* @return 跳转的界面
*/
//@validated来校验数据,如果数据异常则会统一抛出异常,方便异常中心统一处理。 Book.Add.class与实体类中声明的分组想关联
//比如,我们判断一个输入参数是否合法
//@ModelAttribute("book")将数据添加到模型对象中,用于视图页面展示时使用
@RequestMapping("/addBook")
public String addBook(@Validated(Book.Add.class) @ModelAttribute("book") Book book, BindingResult bindingResult){
//判断是否有错误结果
if(bindingResult.hasErrors()){
//如果有则在不跳转,并在增加界面上显示
return "book/addBook";
}
//调用增加方法
bookService.addBook(book);
return "redirect:/books";
}
}
前台界面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%--调用Spring标签库--%>
<%@taglib prefix="f" uri="http://www.springframework.org/tags/form" %>
<html>
<%--下面提交中action不兼容<%=request.getContextPath()%> 所以改用--%>
<%
request.setAttribute("ctx", request.getContextPath());
%>
<head>
<title>Title</title>
</head>
<body>
<%--这里需要使用<f:form>标签 <f:input path="与之前的name一致"/> <f:errors path="或去name打印规则信息及实体类中message中的值"/>--%>
<f:form method="post" action="${ctx}/addBook" modelAttribute="book">
书本名称<f:input path="bname"/><f:errors path="bname"/><br/>
书本价格<f:input path="price"/><f:errors path="price"/><br/>
书本类型<f:input path="type"/><f:errors path="type"/><br/>
<input type="submit" value="提交"/>
</f:form>
</body>
</html>
运作测试结果
总结
需要注意注解的使用及需要导对正确的包