SpringMVC（二）

SpringMVC（二）

通过上一篇 SpringMVC 的博文，我们掌握了如何新建 SpringMVC 项目，了解了其大致工作原理，了解了常用的注解，知道了 REST 风格的架构，通过源码初步了解到了数据绑定的流程。接着上次我们继续对 SpringMVC 进行学习。

数据绑定、校验、格式化

• SpringMVC 通过反射机制对目标处理方法进行解析，将请求消息绑定到处理方法的入参中。

• 数据绑定流程

  1. SpringMVC 将 ServletRequest 对象及目标方法的入参实例传递给 WebDataBinderFactory 实例，以创建 WebDataBinder 实例
  2. DataBinder 调用装配在 SpringMVC 上下文中的 ConversionService 组件进行数据类型转换、数据格式化工作，将请求信息填充到入参对象中
  3. 调用 Validator 组件对已经绑定了请求信息的入参对象进行数据合法性校验，并最终生成数据绑定结果 BindingData 对象
  4. SpringMVC 抽取 BindingResult 中的入参对象和校验错误对象，将他们赋给处理方法的响应入参

• 配置

  • 该配置在开发中一般都会添加。
    • 
  • 功能
    • 会自动注册 RequestMappingHandlerMapping、RequestMappingHandlerAdapter 与 ExceptionHandlerExceptionResolver 三个 bean
    • 支持使用 ConversionService 实例对表单参数进行类型转换
    • 支持使用 @NumberFormatannotation、@DataTimeFormat 注解完成数据类型的格式化
    • 支持使用 @Valid 注解对 JavaBean 进行 JSR 303 验证
    • 支持使用 @RequestBody 和 @ReponseBody 注解（处理 Ajax 请求）

• @InitBinder 注解

  • 由 @InitBinder 标识的方法，可以对 WebDataBinder 对象进行初化。WebDataBinder 是 DataBinder 的子类，用于完成由表单字段 JavaBean 属性的绑定
  • @InitBinder方法不能有返回值，它必须声明为 void
  • @InitBinder方法的参数通常是 WebDataBinder，它可以对 DataBinder 进行初始化和一些设置，如设置绑定过程中使得某些字段不被赋值

• 数据格式化

  • Spring 在格式化模块中定义了一个实现 ConversionService 接口的 FormattingConversionService 实现类，该实现类扩展了 GenericConversionService，因此它既具有类型转换的功能，又具有格式化的功能
  • mvc:annotation-driven/ 默认创建的 ConversionService 实例即为 FormattingConversionServiceFactroyBean（支持数据和日期的格式化）
  • FormattingConversionServiceFactroyBean 内部已经注册了 :

    • NumberFormatAnnotationFormatterFactroy：支持对数字类型的属性使用 @NumberFormat 注解

    • JodaDateTimeFormatAnnotationFormatterFactroy：支持对日期类型的属性使用 @DateTimeFormat 注解

        @DateTimeFormat(pattern = "yyyy/mm/dd")
        private Date birth;
        @NumberFormat(pattern = "#,###,###.#")
        private float salary;
      

• 数据校验

  • 如何校验

    • 使用 JSR303 验证标准
    • 加入 hibernate-validator 验证框架，即 jar 包
    • 加入 注解
    • 在 bean 属性上添加对应的注解
    • 目标方法 bean 的属性上添加 @valid 注解
    • 注意：需要校验的 Bean 对象和其绑定结果或错误对象成对出现时，他们之间不允许声明其他入参

  • JSR 303

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

  • jar 包

      <dependency>
      	<groupId>org.hibernate</groupId>
      	<artifactId>hibernate-validator</artifactId>
      	<version>4.3.1.Final</version>
      </dependency>
    

  • 实体上添加注解

    • 

  • 处理方法中添加 @valid 注解

    • 

格式化、校验错误的消息处理

• 若数据的校验以及格式化出错，我们先将其默认的错误消息打印到控制台，下面的代码将打印出具体的哪一个字段的什么错误。

    @RequestMapping(value = "/emp", method = RequestMethod.POST)
    public String add(@Valid Employee employee, Errors result, Map<String, Object> map) {
    //        打印错误消息
        if (result.getErrorCount() > 0) {
            System.out.println("出错了！");
            for (FieldError fieldError : result.getFieldErrors()) {
                System.out.println(fieldError.getField() + " --> " + fieldError.getDefaultMessage());
            }
        }
        employeeDao.save(employee);
        return "redirect:/employeeList";
    }
  

• 

• 将错误消息显示在页面上

  • 转回原页面，并会回显输入的错误记录
  • 页面上使用标签显示错误消息
  • 

• 如何覆盖错误消息以及将错误消息国际化

  • 数据匹配是指是否和规定的格式一样，数据校验是指是否符合规定，我们可以配置国际化资源文件 i18n.properties，以及在 spring-c···onfig.xml 文件中配国际化资源，从而达到国际化资源消息的目标
  • properties 文件中声明不同错误对应不同的错误消息格式，对于校验使用对应的校验前缀（如 NotEmpty），对于类型错误使用 typeMismatch；
  • properties 文件中的第二个为 @ModelAttribute 标注的 value，或是类名的第一个字母消息，如 employee
  • 
  • 

SpringMVC 处理 JSON

• 导入 jar 包

    	<spring.verison>4.3.8.RELEASE</spring.verison>
    	<jackson.version>2.8.7</jackson.version>
    <dependency>
    	<groupId>com.fasterxml.jackson.core</groupId>
    	<artifactId>jackson-core</artifactId>
    	<version>${jackson.version}</version>
    </dependency>
    <dependency>
    	<groupId>com.fasterxml.jackson.core</groupId>
    	<artifactId>jackson-annotations</artifactId>
    	<version>${jackson.version}</version>
    </dependency>
    <dependency>
    	<groupId>com.fasterxml.jackson.core</groupId>
    	<artifactId>jackson-databind</artifactId>
    	<version>${jackson.version}</version>
    </dependency>
  

• 目标操作方法添加注解（目标方法返回一个对象或集合）

    @ResponseBody
    @RequestMapping("/testJson")
    public Collection<Employee> testJson() {
    	System.out.println("Succ");
    	Collection<Employee> values = employeeDao.getEmployeeMap().values();
    return values;
    }
  

• 目标页面发送 Ajax 请求以及处理返回值

    $(function () {
    	$("#testJson").click(function () {
    		var url = this.href;
    		var args = {};
    
    		$.post(url, args, function(data) {
    			for (var i = 0; i < data.length; i++) {
    				var lastName = data[i].lastName;
    				var email = data[i].email;
    
    				alert(lastName + ", " + email);
    			}
    		})
    		return false;
    	})
    })
  

SpringMVC 运行流程（其中 <mvc:default-servlet-handler /> 为请求静态资源）

• 

SpringMVC 和 Spring

• 需要进行 Spring 整合 SpringMVC 吗？
  • 需要，通常情况下，将类似于数据源，事务，整合其他框架都是放在 Spring 的配置文件中，而不是 SpringMVC 文件中，实际上放入 Spring 配置文件对应的 IOC 容器中的还有 Service 和 Dao
  • 不需要，都放在 SpringMVC 的配置文件中，也可以分多个 Spring 的配置文件，然后使用 import 节点导入其他的配置文件
• 问题
  • 若 Spring 的 IOC 容器和 SpringMVC 的 IOC 容器扫描的包有重合的部分，就会导致 bean 被创建两次
• 解决
  • 使用 exclude-filter 和 include-filter 子节点规定只扫描的注解，SpringMVC 的 IOC 容器只扫描 @Controller（Handler 类） 和 @ControllerAdvice（处理异常的类），Spring 不扫描这两个注解注解的类
• SpringMVC IOC 容器中的 bean 可以引用 Spring IOC 容器中的 Bean，反之不行。

大牛们，觉得有任何问题和不足还希望指出，共同进步，谢谢！