21.16.12 消息转换器

使用MVC Java编程配置方式时,如果你想替换Spring MVC提供的默认转换器,完全定制自己的HttpMessageConverter,这可以通过覆写configureMessageConverters()方法来实现。如果你只是想定制一下,或者想在默认转换器之外再添加其他的转换器,那么可以通过覆写extendMessageConverters()方法来实现。

下面是一段例子,它使用定制的ObjectMapper构造了新的Jackson的JSON和XML转换器,并用它们替换了默认提供的转换器:

  1. @Configuration
  2. @EnableWebMvc
  3. public class WebConfiguration extends WebMvcConfigurerAdapter {
  4. @Override
  5. public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
  6. Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder()
  7. .indentOutput(true)
  8. .dateFormat(new SimpleDateFormat("yyyy-MM-dd"))
  9. .modulesToInstall(new ParameterNamesModule());
  10. converters.add(new MappingJackson2HttpMessageConverter(builder.build()));
  11. converters.add(new MappingJackson2XmlHttpMessageConverter(builder.xml().build()));
  12. }
  13. }

在上面的例子中,Jackson2ObjectMapperBuilder用于为MappingJackson2HttpMessageConverterMappingJackson2XmlHttpMessageConverter转换器创建公共的配置,比如启用tab缩进、定制的日期格式,并注册了一个模块jackson-module-parameter-names用于获取参数名(Java 8新增的特性)

除了jackson- dataformat-xml,要启用Jackson XML的tab缩进支持,还需要一个woodstox-core-asl依赖。

还有其他有用的Jackson模块可以使用:

  1. jackson-datatype-money:提供了对javax.money类型的支持(非官方模块)
  2. jackson-datatype-hibernate:提供了Hibernate相关的类型和属性支持(包含懒加载aspects)

在XML做同样的事也是可能的:

  1. <mvc:annotation-driven>
  2. <mvc:message-converters>
  3. <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
  4. <property name="objectMapper" ref="objectMapper"/>
  5. </bean>
  6. <bean class="org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter">
  7. <property name="objectMapper" ref="xmlMapper"/>
  8. </bean>
  9. </mvc:message-converters>
  10. </mvc:annotation-driven>
  11. <bean id="objectMapper" class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
  12. p:indentOutput="true"
  13. p:simpleDateFormat="yyyy-MM-dd"
  14. p:modulesToInstall="com.fasterxml.jackson.module.paramnames.ParameterNamesModule"/>
  15. <bean id="xmlMapper" parent="objectMapper" p:createXmlMapper="true"/>