21.16.1 启用MVC Java编程配置或MVC命名空间

要启用MVC Java编程配置，你需要在其中一个注解了@Configuration的类上添加@EnableWebMvc注解：

  1. @Configuration
  2. @EnableWebMvc
  3. public class WebConfig {
  5. }

要启用XML命名空间，请在你的DispatcherServlet上下文中（如果没有定义任何DispatcherServlet上下文，那么就在根上下文中）添加一个mvc:annotation-driven元素：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3.     xmlns:mvc="http://www.springframework.org/schema/mvc"
  4.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  5.     xsi:schemaLocation="
  6.         http://www.springframework.org/schema/beans
  7.         http://www.springframework.org/schema/beans/spring-beans.xsd
  8.         http://www.springframework.org/schema/mvc
  9.         http://www.springframework.org/schema/mvc/spring-mvc.xsd">
  11.     <mvc:annotation-driven/>
  13. </beans>

上面的简单的声明代码，就已经默认注册了一个RequestMappingHandlerMapping、一个RequestMappingHandlerAdapter，以及一个ExceptionHandlerExceptionResolver，以支持对使用了@RequestMapping、@ExceptionHandler及其他注解的控制器方法的请求处理。

同时，上面的代码还启用了以下的特性：

  1. Spring 3风格的类型转换支持。这是使用一个配置的转换服务ConversionService实例，以及the JavaBeans PropertyEditors used for Data Binding.
  2. 使用@NumberFormat对数字字段进行格式化，类型转换由ConversionService实现
  3. 使用@DateTimeFormat注解对Date、Calendar、Long及Joda Time类型的字段进行格式化
  4. 使用@Valid注解对@Controller输入进行验证——前提是classpath路径下比如提供符合JSR-303规范的验证器
  5. HTTP消息转换HttpMessageConverter的支持，对注解了@RequestMapping或@ExceptionHandler方法的@RequestBody方法参数或@ResponseBody返回值生效

下面给出了一份由mvc:annotation-driven注册可用的HTTP消息转换器的完整列表：

  1. 转换字节数组的ByteArrayHttpMessageConverter
  2. 转换字符串的StringHttpMessageConverter
  3. ResourceHttpMessageConverter：org.springframework.core.io.Resource与所有媒体类型之间的互相转换
  4. SourceHttpMessageConverter：从（到）javax.xml.transform.Source的转换
  5. FormHttpMessageConverter：数据与MultiValueMap<String, String>之间的互相转换
  6. Jaxb2RootElementHttpMessageConverter：Java对象与XML之间的互相转换——该转换器在classpath路径下有JAXB2依赖并且没有Jackson 2 XML扩展时被注册
  7. MappingJackson2HttpMessageConverter：从（到）JSON的转换——该转换器在classpath下有Jackson 2依赖时被注册
  8. MappingJackson2XmlHttpMessageConverter：从（到）XML的转换——该转换器在classpath下有Jackson 2 XML扩展时被注册
  9. AtomFeedHttpMessageConverter：Atom源的转换——该转换器在classpath路径下有Rome时被注册
  10. RssChannelHttpMessageConverter：RSS源的转换——该转换器在classpath路径下有Rome时被注册

你可以参考21.16.12 消息转换器一小节，了解如何进一步定制这些默认的转换器。

Jackson JSON和XML转换器是通过Jackson2ObjectMapperBuilder创建的ObjectMapper实例创建的，目的在于提供更好的默认配置

该builder会使用以下的默认属性对Jackson进行配置：

  1. 禁用DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES

  2. 禁用MapperFeature.DEFAULT_VIEW_INCLUSION

同时，如果检测到在classpath路径下存在这些模块，该builder也会自动地注册它们：

  1. jackson-datatype-jdk7: 支持Java 7的一些类型，例如java.nio.file.Path

  2. jackson-datatype-joda: 支持Joda-Time类型

  3. jackson-datatype-jsr310: 支持Java 8的Date & Time API类型

  4. jackson-datatype-jdk8: 支持Java 8其他的一些类型，比如Optional等