SpringMVC 数据的格式化、JSR 303数据校验和国际化

---

---

1 数据的格式化

User.java

public class User {

    @DateTimeFormat(pattern="yyyy-MM-dd")
    private Date birth;
    .
    .
}

例如 User类 的属性 birth 是一个 Date 类型，必须在实体类中声明格式，否则不能从表单提交到 @Controller注解的类中对应的方法处理。

2 JSR 303数据校验

JSR 303是 Java 为 Bean 数据合法性校验提供给的标准框架，已经包含在 JavaEE6.0中、JSR 303通过在Bean 属性中标注类似 @NotNull @Max 等标准的注解指定校验规则，并通过标准的验证接口对 Bean进行验证

HIbernate Validator 是 JSR 303 的一个参考实现，除了支持所有标准的校验注解外，
它还支持一些扩展注解，下面是详细的注解列表

JSR 303中含有的注解

@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=)  被注释的元素必须在合适的范围内  

3 JSR 303数据校验在Spring中使用

Spring 4.0拥有自己的数据库校验框架，同时支持JSR 303标准校验框架。
Spring 在进行数据绑定时，可同时调用校验框架完成校验工作。在SpringMVC中，可直接通过注解驱动的方式进行数据校验

Spring 的LocalValidatorFactoryBean 即实现了Spring的Validator 接口，也实现了JSR 303 的Validator 接口。
只要在Spring 容器中定义一个LocalValidatorFactoryBean ，即可将其注入到需要数据校验的 Bean中。

Spring 本身并没有提供JSR 303 的实现，所有必须将JSR 303的实现者的jar 包（HIbernate Validator jar包）导入到项目中

Maven 仓库地址：

<dependency>
    <groupId>org.hibernategroupId>
    <artifactId>hibernate-validatorartifactId>
    <version>5.3.4.Finalversion>
dependency>

会默认装配好一个LocalValidatorFactoryBean，通过在处理方法的入参上标注 @Valid 注解即可让 SpringMVC 在完成数据绑定后执行数据校验工作
在已经标注了 JSR 303 注解的表单、命令对象前标注一个@Valid，SpringMVC框架在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验

4 校验信息如何显示

SpringMVC 除了会将表单、命令对象的校验结果保存到对应的 BindingResult 或Error对象外，还会将所有校验结果保存到“隐含模型”。
即使处理方法中的签名中没有对应于表单/命名对象的结果入参，校验结果也会保存在“隐含对象”中。

（比如User的IDCard没有指定校验的注解，可以它要求是Float型，输入String型数据，发生类型错误也会保存到隐含对象中输出）

隐含模型中的所有数据最终将通过HttpServletRequest的属性列表暴露个JSP视图对象，因此在JSP中可以获取错误信息
在JSP页面上可通过下面的标签显示

<form:errors path="*" /> 显示表单所有错误
<form:errors path="user* /> 显示所有以user为前缀的属性对应的错误
username"/> 显示特定表单对象属性的错误

5 国际化

当使用 SpringMVC 标签显示错误消息时，SpringMVC 会查看WEB上下文是否装配了对应的国际化消息，如果没有，则显示默认的错误消息，否则使用国际化消息

若数据类型转换或数据格式转换时发生错误，或该有的参数不存在，或调用处理方法时发生错误，都会在隐含模型创建错误消息，其错误代码前缀（在国际化文件中配置）说明如下：

• required：必要的参数不存在。
  @RequiredParam("param1")标注了一个入参，但是该参数不存在

• typeMismatch ：在数据绑定是，发生数据类型不匹配的问题

• methodInvocation ：SpringMVC 在调用处理方法时发生了错误

例如：
i18n_zh_CN.properties

NotEmpty.user.name= \u59D3\u540D\u4E0D\u80FD\u4E3A\u7A7A\u554A
Email.user.email= \u90AE\u7BB1\u683C\u5F0F\u4E0D\u5BF9\u54E6
Past.user.birth= \u4F60\u51FA\u751F\u65E5\u671F\u5728\u660E\u5929\uFF1F
typeMismatch.user.birth=Birth\u4E0D\u662F\u4E00\u4E2A\u65E5\u671F

在SpringMVC中配置

    
     <bean id="messageSource"
        class="org.springframework.context.support.ResourceBundleMessageSource">
        <property name="basename" value="i18n">property>
        bean>

6 项目结构

红色标注的为 HIbernate Validator jar包
官网下载地址 http://hibernate.org/validator/
解压后，使用dist和\dist\lib\required两个目录下部分jar包

源代码下载（包含jar包）：http://download.csdn.net/detail/peng_hong_fu/9707572

7 版本信息

Eclipse版本 Neon.1a Release (4.6.1)
Spring 4.3.4
hibernate-validator-5.3.3

源代码

web.xml和SpringMVC文件配置

web.xml

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
  <display-name>springmvc-dataFormatdisplay-name>
    
      <filter>  
          <filter-name>SetCharacterEncodingfilter-name>  
          <filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>  
          <init-param>  
               <param-name>encodingparam-name>  
               <param-value>UTF-8param-value>  
          init-param>  
          <init-param>  
               <param-name>forceEncodingparam-name>  
               <param-value>trueparam-value>  
                 
          init-param>  
     filter>  
     <filter-mapping>  
          <filter-name>SetCharacterEncodingfilter-name>  
          <url-pattern>/*url-pattern>  
     filter-mapping>  

  
    <servlet>
        <servlet-name>springDispatcherServletservlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
        
        
        <init-param>
            <param-name>contextConfigLocationparam-name>
            <param-value>classpath:springmvc.xmlparam-value>
        init-param>
        <load-on-startup>1load-on-startup>
    servlet>

    
    <servlet-mapping>
        <servlet-name>springDispatcherServletservlet-name>
        <url-pattern>/url-pattern>
    servlet-mapping>

web-app>

springmvc.xml

<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:aop="http://www.springframework.org/schema/aop"
    xmlns:context="http://www.springframework.org/schema/context"
    xmlns:mvc="http://www.springframework.org/schema/mvc"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.3.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">

    <context:component-scan base-package="com.jxust.dataformat">context:component-scan>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/views/">property>
        <property name="suffix" value=".jsp">property>
    bean>

    <mvc:default-servlet-handler/>
    <mvc:annotation-driven>mvc:annotation-driven>
     
     <bean id="messageSource"
        class="org.springframework.context.support.ResourceBundleMessageSource">
        <property name="basename" value="i18n">property>
        bean>
beans>

的作用

会自动注册 RequestMappingHandlerMapping、RequestMappingHandlerAdapter
和ExceptionHandlerExceptionResolver三个bean

还提供了以下的支持
-支持使用ConversionService 示例对表单参数进行类型转换
-支持使用@NumberFormatannotation、@DateTimeFormat 注解完成数据类型的格式化
-支持使用 @Valid 注解对 JavaBean 实例进行JSR 303验证
-支持使用@RequestBody 和 @ResponseBody 注解

实体类

User.java

package com.jxust.dataformat.entity;

import java.util.Date;

import javax.validation.constraints.Past;

import org.hibernate.validator.constraints.Email;
import org.hibernate.validator.constraints.NotEmpty;
import org.hibernate.validator.constraints.Range;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.format.annotation.NumberFormat;

public class User {
    @Range(min=100,max=11,message="内容必须在11到100之间")
    private Integer id;
    @NotEmpty
    private String name;
    @Email
    private String email;

    @NumberFormat(pattern="#,###,###,#")
    private Float idCard;
    @Past
    @DateTimeFormat(pattern="yyyy-MM-dd")
    private Date birth;
    //birth 和idCard 的格式声明，输入的格式就必须匹配

    //省略 getter and setter

    @Override
    public String toString() {
        return "User [id=" + id + ", name=" + name + ", email=" + email + ", idCard=" + idCard + ", birth=" + birth
                + "]";
    }   
}

Controller

DataFormatHandler.java

package com.jxust.dataformat.handler;

import java.util.Map;

import javax.validation.Valid;

import org.springframework.stereotype.Controller;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.annotation.RequestMapping;

import com.jxust.dataformat.entity.User;

@Controller
public class DataFormatHandler {
    /**
     * 跳转到输入页面input.jsp
     * 
     * @param map
     * @return
     */
    @RequestMapping("/input")
    public String dataformat(Map map) {
        /**
         * 对应 form表单的 modelAttribute="user"
         *  因为表单默认是要回显的，这里传入一个空对象
         */
        map.put("user", new User());
        return "input";
    }

    /**
     * input界面提交表单数据的处理方法，在这个方法中进行数据校验
     *  注意： 
     *  需要校验 bean 对象和其绑定结果对象或错误结果（Error)
     * @Valid User user,BindingResult result 两个入参必须成对出现，中间不允许其他入参分隔
     * @param user
     * @param result
     * @return
     */
    @RequestMapping("/testinput")
    public String testinput(@Valid User user, BindingResult result) {
        System.out.println(user.toString());
        /**
         * 类型转换失败时的错误信息输出
         */
        if (result.getErrorCount() > 0) {
            System.out.println("出错了...");
            for (FieldError error : result.getFieldErrors()) {
                System.out.println(error.getField() + ":" + error.getDefaultMessage());
            }
            // 验证出错，则转向特定的页面（这里是之前的输入的页面）
            return "input";
        }
        return "success";
    }
}

SpringMVC 是通过对处理方法签名的规则来保存校验结果的，前一个表单、命令对象的校验结果保存到随后的入参中，这个保存校验结果的入参必须是 BindingResult 或 Errors类型(这里使用的是BindingResult），这两个类都位于 org.springframework.validation

JSP页面

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>测试表单数据格式化title>
head>
<body>
    <a href="input">To Inputa>
body>
html>

input.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%>

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title heretitle>
head>
<body>
            
    <form:form action="testinput" method="post" modelAttribute="user">  
        <form:errors path="*">form:errors><br>

        id:<form:input path="id"/>
        <form:errors path="id">form:errors><br>

        name:<form:input path="name"/>
        <form:errors path="name">form:errors><br>

        email:<form:input path="email"/>
        <form:errors path="email">form:errors><br>

        idCard:<form:input path="idCard"/>
        <form:errors path="idCard">form:errors><br>

        birth:<form:input path="birth"/>
        <form:errors path="birth">form:errors><br>
        <input type="submit" value="提交"/>
    form:form>  
body>
html>

success.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title heretitle>
head>
<body>
    <h2>successh2>
body>
html>

国际化文件

i18n_zh_CN.properties

NotEmpty.user.name= \u59D3\u540D\u4E0D\u80FD\u4E3A\u7A7A\u554A
Email.user.email= \u90AE\u7BB1\u683C\u5F0F\u4E0D\u5BF9\u54E6
Past.user.birth= \u4F60\u51FA\u751F\u65E5\u671F\u5728\u660E\u5929\uFF1F
typeMismatch.user.birth=Birth\u4E0D\u662F\u4E00\u4E2A\u65E5\u671F

笔记.txt

声明了格式,才能正常的使用
    @DateTimeFormat(pattern="yyyy-MM-dd")
    private Date birth;
输出的内容为：
User [id=1, name=ee, email=ee, idCard=12134.0, birth=Sun Sep 09 00:00:00 CDT 1990]
---------------------
声明了birth和idCard的格式，故意输入错误格式，输出的内容为：
User [id=null, name=, email=ee, idCard=null, birth=null]
出错了...
birth:Failed to convert property value of type 'java.lang.String' to required type 'java.util.Date' for property 'birth'; nested exception is org.springframework.core.convert.ConversionFailedException: Failed to convert from type [java.lang.String] to type [@javax.validation.constraints.Past @org.springframework.format.annotation.DateTimeFormat java.util.Date] for value '2033-09-'; nested exception is java.lang.IllegalArgumentException: Parse attempt failed for value [2033-09-]
idCard:Failed to convert property value of type 'java.lang.String' to required type 'java.lang.Float' for property 'idCard'; nested exception is java.lang.NumberFormatException: For input string: "ee"

---------------------
使用了@Valid,格式校验启动，故意输入错误格式，输出的内容为：

User [id=null, name=, email=ee, idCard=null, birth=Fri Sep 09 00:00:00 CST 2033]
出错了...
email:不是一个合法的电子邮件地址
name:不能为空
birth:需要是一个过去的时间

源代码下载

下载地址：http://download.csdn.net/detail/peng_hong_fu/9707572