提要:spring mvc 在@ResponseBody或者response.getWriter().print()的时候,默认会通过其内置的系列converters进行自动转换,接口如下:
org.springframework.http.converter.HttpMessageConverter<T>
其中,比较常用的有以下几个:
org.springframework.http.converter.StringHttpMessageConverter,实现string类型转换
org.springframework.http.converter.ByteArrayHttpMessageConverter,二进制类型转换
org.springframework.http.converter.MappingJackson2HttpMessageConverter,json类型转换
以上转换器,是通过对request里面的Accept属性进行逐个解析并匹配实现(逗号分隔),如果相关converter配置出现错误,就会导致异常发生,以及可能导致响应406出现。
一般出现这样的情况多半是直接配置了RequestMappingHandlerAdapter这个类(比如请求为json类型时,就会无法自动转换,返回结果响应406 not accepted),因为它默认只会注册以下几个转换器:
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());
}
为了解决这个问题,我们可以将需要的转换器配置到Adapter类上,但是,配置后会覆盖原有的converters,所以,配置的时候需要配置全面。更为简单的做法是不去配置HandlerAdapter这个类,而是直接配置<mvc:annotation-driven />
,这个配置会默认配置HandlerAdapter以及HandlerMapping,并且会自动注册大部分的converters:
AnnotationDrivenBeanDefinitionParser类下的parse方法:
@Override
public BeanDefinition parse(Element element, ParserContext parserContext) {
Object source = parserContext.extractSource(element);
CompositeComponentDefinition compDefinition = new CompositeComponentDefinition(element.getTagName(), source);
parserContext.pushContainingComponent(compDefinition);
RuntimeBeanReference contentNegotiationManager = getContentNegotiationManager(element, source, parserContext);
RootBeanDefinition handlerMappingDef = new RootBeanDefinition(RequestMappingHandlerMapping.class);
handlerMappingDef.setSource(source);
handlerMappingDef.setRole(BeanDefinition.ROLE_INFRASTRUCTURE);
handlerMappingDef.getPropertyValues().add("order", 0);
handlerMappingDef.getPropertyValues().add("contentNegotiationManager", contentNegotiationManager);
String methodMappingName = parserContext.getReaderContext().registerWithGeneratedName(handlerMappingDef);
if (element.hasAttribute("enable-matrix-variables")) {
Boolean enableMatrixVariables = Boolean.valueOf(element.getAttribute("enable-matrix-variables"));
handlerMappingDef.getPropertyValues().add("removeSemicolonContent", !enableMatrixVariables);
}
else if (element.hasAttribute("enableMatrixVariables")) {
Boo