SpringMVC（二） - HelloWorld开发者社区

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，反之不行。