JSR 303
JSR 303 是 Java 为 Bean 数据合法性校验提供的标准框架,
它已经包含在 JavaEE 6.0 中 .
JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max
等标准的注解指定校验规则,并通过标准的验证接口对 Bean 进行验证
Hibernate Validator 扩展注解
Spring MVC 数据校验
Spring 4.0 拥有自己独立的数据校验框架,同时支持 JSR 303 标准的校验框架。
Spring 在进行数据绑定时,可同时调用校验框架完成数据校 验工作。在 Spring MVC 中,可直接通过注解驱动的方式进行数据校验
Spring 的 LocalValidatorFactroyBean 既实现了 Spring 的Validator 接口,也实现了 JSR 303 的 Validator 接口。只要
在 Spring 容器中定义了一个LocalValidatorFactoryBean,即可将其注入到需要数据校验的 Bean 中。
Spring 本身并没有提供 JSR303 的实现,所以必须将JSR303 的实现者的 jar 包放到类路径下。
<mvc:annotation-driven/> 会默认装配好一个 LocalValidatorFactoryBean,通过在处理方法的入参上标注 @valid 注解即可让 Spring MVC 在完成数据绑定后执行数据校验的工作
在已经标注了 JSR303 注解的表单/命令对象前标注一个 @Valid,Spring MVC 框架在将请求参数绑定到该入参对象后,就会调用校验框架根据注解声明的校验规则实施校验
Spring MVC 是通过对处理方法签名的规约来保存校验结果的:前一个表单/命令对象的校验结果保存到随后的入参中,这个保存校验结果的入参必须是 BindingResult 或
Errors 类型,这两个类都位于org.springframework.validation 包中
需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的,它们之间不允许声明其他的入参
如:public String handle 91(@Valid User user, BindingResult userBindingResult,String sessionId,ModelMap mm,@Valid Dept dept , Errors deptErrors){}
Errors 接口提供了获取错误信息的方法,如 getErrorCount() 或getFieldErrors(String field) BindingResult 扩展了 Errors 接口
在页面上显示错误
Spring MVC 除了会将表单/命令对象的校验结果保存到对 应的 BindingResult 或 Errors 对象中外,还会将所有校验结果保存到 “隐含模型”
即使处理方法的签名中没有对应于表单/命令对象的•结果入参,校验结果也会保存在 “隐含对象” 中。
隐含模型中的所有数据最终将通过 HttpServletRequest 的属性列表暴露给 JSP 视图对象,因此在 JSP 中可以获取
错误信息在 JSP 页面上可通过 <form:errors path=“userName”> 显示错误消息
示例
提示消息的国际化
每个属性在数据绑定和数据校验发生错误时,都会生成一 个对应的 FieldError 对象。
当一个属性校验失败后,校验框架会为该属性生成 4 个消息代码,这些代码以校验注解类名为前缀,结合
modleAttribute、属性名及属性类型名生成多个对应的消息代码:
例如 User 类中的 password 属性标准了一个 @Pattern 注解,当该属性值不满足 @Pattern 所定义的规则时, 就会产生以下 4个错误代码:
Pattern.user.password –
Pattern.password –
Pattern.java.lang.String –
Pattern –
当使用 Spring MVC 标签显示错误消息时, Spring MVC 会查看WEB 上下文是否装配了对应的国际化消息,如果没有,则显示默认的错误消息,否则使用国际化消息。
1). 如何校验 ? 注解 ?
①. 使用 JSR 303 验证标准
②. 加入 hibernate validator 验证框架的 jar 包
③. 在 SpringMVC 配置文件中添加 <mvc:annotation-driven />
④. 需要在 bean 的属性上添加对应的注解
⑤. 在目标方法 bean 类型的前面添加 @Valid 注解
2). 验证出错转向到哪一个页面 ?
注意: 需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的,它们之间不允许声明其他的入参
3). 错误消息 ? 如何显示, 如何把错误消息进行国际化
input.jsp
<form:form action="${pageContext.request.contextPath }/emp"
method="POST" modelAttribute="employee">
<form:errors path="*"></form:errors><!-- 显示所有的错误校验 -->
<br>
<c:if test="${empolyee.id ==null }">
<!-- path属性对应html 表单标签的name属性 -->
LastName:<form:input path="lastName" />
<form:errors path="lastName"></form:errors><!-- 显示lastName检验 -->
</c:if>
<c:if test="${empolyee.id !=null }">
<form:hidden path="id"/>
<input type="hidden" name="_method" value="PUT">
</c:if>
<br>
Email:<form:input path="email" />
<form:errors path="email"></form:errors>
<br>
<%
Map<String, String> genders = new HashMap();
genders.put("1", "Male");
genders.put("0", "Female");
request.setAttribute("genders", genders);
%>
Gender:<form:radiobuttons path="gender" items="${genders}"
delimiter="<br>" />
<br>
Department:<form:select path="department.id" items="${departments}"
itemLabel="departmentName" itemValue="id"></form:select>
<br>
Birth:<form:input path="birth"/>
<form:errors path="birth"></form:errors>
<br>
salary:<form:input path="salary"/>
<br>
<input type="submit" value="Submit" />
</form:form>
</body>
</html>
controller
@RequestMapping(value = "/emp", method = RequestMethod.POST)
public String save(@Valid Employee employee,Errors result,Map<String,Object> map) {
if(result.getErrorCount()>0){
System.out.println("出错了!");
for (FieldError error : result.getFieldErrors()) {
System.out.println(error.getField()+":"+error.getDefaultMessage());
}
//若验证出错,则转向定制的页面
map.put("departments", departmentDao.getDepartments());
return "input";
}
System.out.println(employee.getBirth());
System.out.println(employee.getSalary());
employeeDao.save(employee);
return "redirect:/emps";
}
在javabean上注解
@NotEmpty
private String lastName;
@Email
private String email;
@Past
@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birth;
使用提示消息的国际化
在src新建i18n.properties文件
格式:javabean 属性上的注解加类名第一个字母小写再加属性
NotEmpty.employee.lastName=lastName不能为空
Email.employee.email=Email格式不正确
Past.employee.birth=Birth必须是以前的时间
springmvc配置文件
<!-- 配置国际化资源文件 -->
<bean id="messageSource"
class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basename" value="i18n"></property>
</bean>