21.16.1 启用MVC Java编程配置或MVC命名空间
要启用MVC Java编程配置,你需要在其中一个注解了@Configuration
的类上添加@EnableWebMvc
注解:
@Configuration
@EnableWebMvc
public class WebConfig {
}
要启用XML命名空间,请在你的DispatcherServlet上下文中(如果没有定义任何DispatcherServlet上下文,那么就在根上下文中)添加一个mvc:annotation-driven
元素:
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<mvc:annotation-driven/>
</beans>
上面的简单的声明代码,就已经默认注册了一个RequestMappingHandlerMapping
、一个RequestMappingHandlerAdapter
,以及一个ExceptionHandlerExceptionResolver
,以支持对使用了@RequestMapping
、@ExceptionHandler
及其他注解的控制器方法的请求处理。
同时,上面的代码还启用了以下的特性:
- Spring 3风格的类型转换支持。这是使用一个配置的转换服务ConversionService实例,以及the JavaBeans PropertyEditors used for Data Binding.
- 使用
@NumberFormat
对数字字段进行格式化,类型转换由ConversionService
实现 - 使用
@DateTimeFormat
注解对Date
、Calendar
、Long
及Joda Time类型的字段进行格式化 - 使用
@Valid
注解对@Controller
输入进行验证——前提是classpath路径下比如提供符合JSR-303规范的验证器 - HTTP消息转换
HttpMessageConverter
的支持,对注解了@RequestMapping
或@ExceptionHandler
方法的@RequestBody
方法参数或@ResponseBody
返回值生效
下面给出了一份由mvc:annotation-driven
注册可用的HTTP消息转换器的完整列表:
- 转换字节数组的
ByteArrayHttpMessageConverter
- 转换字符串的
StringHttpMessageConverter
ResourceHttpMessageConverter
:org.springframework.core.io.Resource
与所有媒体类型之间的互相转换SourceHttpMessageConverter
:从(到)javax.xml.transform.Source
的转换FormHttpMessageConverter
:数据与MultiValueMap<String, String>
之间的互相转换Jaxb2RootElementHttpMessageConverter
:Java对象与XML之间的互相转换——该转换器在classpath路径下有JAXB2依赖并且没有Jackson 2 XML扩展时被注册MappingJackson2HttpMessageConverter
:从(到)JSON的转换——该转换器在classpath下有Jackson 2依赖时被注册MappingJackson2XmlHttpMessageConverter
:从(到)XML的转换——该转换器在classpath下有Jackson 2 XML扩展时被注册AtomFeedHttpMessageConverter
:Atom源的转换——该转换器在classpath路径下有Rome时被注册RssChannelHttpMessageConverter
:RSS源的转换——该转换器在classpath路径下有Rome时被注册
你可以参考21.16.12 消息转换器一小节,了解如何进一步定制这些默认的转换器。
Jackson JSON和XML转换器是通过
Jackson2ObjectMapperBuilder
创建的ObjectMapper
实例创建的,目的在于提供更好的默认配置该builder会使用以下的默认属性对Jackson进行配置:
同时,如果检测到在classpath路径下存在这些模块,该builder也会自动地注册它们:
jackson-datatype-jdk7: 支持Java 7的一些类型,例如
java.nio.file.Path
jackson-datatype-joda: 支持Joda-Time类型
jackson-datatype-jsr310: 支持Java 8的Date & Time API类型
jackson-datatype-jdk8: 支持Java 8其他的一些类型,比如
Optional
等