在 RESTful接口 盛行的现在, 让接口返回 JSON 格式的字符串,已经成为了大家几乎共同的选择。
之前的项目,通过 spring 来实现了 RESTful,接口返回的就是 JSON的。而且,我一直以为,只要在spring的xml配置文件中开启了<mvc:annotation-driven />
之后,系统就会自动加载 MappingJackson2HttpMessageConverter 这个用于将 HashMap
、List
、POJO
对象转换为 JSON 的 message converter的。
但是,今天自己在新建一个项目之后,按照上面的配置,却怎么也不行。后来看了一下源码,才发现问题所有:
必须将 jackson 对应的jar包引入,spring 才会自动加载上面这个 message converter
为什么会这样?可以先移步至我的另一篇博客大概看一下:mvc:annotation-driven 的变更
从上面这篇blog中,可以看出里面已经有了介绍了。但我还是忘了这一点,导致走了弯路。今天决定看一下源码,增加一下印象,避免以后再走弯路。
具体可以参考以下源码 (RequestMappingHandlerAdapter):
public class RequestMappingHandlerAdapter extends AbstractHandlerMethodAdapter
implements BeanFactoryAware, InitializingBean {
...
public RequestMappingHandlerAdapter() {
StringHttpMessageConverter stringHttpMessageConverter = new StringHttpMessageConverter();
stringHttpMessageConverter.setWriteAcceptCharset(false); // see SPR-7316
this.messageConverters = new ArrayList<HttpMessageConverter<?>>(4);
this.messageConverters.add(new ByteArrayHttpMessageConverter());
this.messageConverters.add(stringHttpMessageConverter);
this.messageConverters.add(new SourceHttpMessageConverter<Source>());
this.messageConverters.add(new AllEncompassingFormHttpMessageConverter());
}
...
}
最重要的是最后这一句:this.messageConverters.add(new AllEncompassingFormHttpMessageConverter())
,
其中,AllEncompassingFormHttpMessageConverter 的实现为:
public class AllEncompassingFormHttpMessageConverter extends FormHttpMessageConverter {
private static final boolean jaxb2Present =
ClassUtils.isPresent("javax.xml.bind.Binder", AllEncompassingFormHttpMessageConverter.class.getClassLoader());
private static final boolean jackson2Present =
ClassUtils.isPresent("com.fasterxml.jackson.databind.ObjectMapper", AllEncompassingFormHttpMessageConverter.class.getClassLoader()) &&
ClassUtils.isPresent("com.fasterxml.jackson.core.JsonGenerator", AllEncompassingFormHttpMessageConverter.class.getClassLoader());
private static final boolean jackson2XmlPresent =
ClassUtils.isPresent("com.fasterxml.jackson.dataformat.xml.XmlMapper", AllEncompassingFormHttpMessageConverter.class.getClassLoader());
private static final boolean gsonPresent =
ClassUtils.isPresent("com.google.gson.Gson", AllEncompassingFormHttpMessageConverter.class.getClassLoader());
public AllEncompassingFormHttpMessageConverter() {
addPartConverter(new SourceHttpMessageConverter<Source>());
if (jaxb2Present && !jackson2XmlPresent) {
addPartConverter(new Jaxb2RootElementHttpMessageConverter());
}
if (jackson2Present) {
addPartConverter(new MappingJackson2HttpMessageConverter());
}
else if (gsonPresent) {
addPartConverter(new GsonHttpMessageConverter());
}
if (jackson2XmlPresent) {
addPartConverter(new MappingJackson2XmlHttpMessageConverter());
}
}
}
相信大家看到这里的时候,就明白了吧。 : )
本文永久更新链接地址:http://www.linuxidc.com/Linux/2017-01/139814.htm