content negotiation using spring mvc

本文写于 13 年前（2013 年 9 月），部分内容可能已经过时。

元数据管理平台的REST接口突然抽风，总是返回XML格式，不管我怎么设置accept头。Debug了一下，发现每次都是优先使用ServletPathExtensionContentNegotitionStrategy。谷歌了一下，原来Spring默认的三个ContentNegotiationStrategy是PPA Strategy (path extension, then parameter, then Accept header) ，顺便也是先path extension，然后parameter(默认是format参数)，然后才是accept头。要让Spring使用accept头解析，只要配置一下ContentNegotiationManagerFactoryBean：

<bean id="contentNegotiationManager"
            class="org.springframework.web.accept.ContentNegotiationManagerFactoryBean">
            <property name="favorPathExtension" value="false" />
            <property name="favorParameter" value="false" />
            <property name="ignoreAcceptHeader" value="false" />
            <property name="mediaTypes">
                    <value>
                            html=text/html
                            json=application/json
                            jsonp=application/javascript
                            *=*/*
                    </value>
            </property>
    </bean>

但是配置之后发现并没有生效，这是最容易出错的一点，就是一定要记得在<mvc:annotation-driven>中配置使用的content-negotiation-manager。因为@ResponseBody是一个anotation来的。Spring处理anotation的配置入口是<mvc:annotation-driven>，会导致重复配置，但是没有办法，只能尽量使用ref了。

<mvc:annotation-driven
	content-negotiation-manager="contentNegotiationManager">
	<mvc:message-converters>
		<bean class="com.qq.b2b2c.api.util.MappingJsonpHttpMessageConverter">
		</bean>
	</mvc:message-converters>
</mvc:annotation-driven>

配置之后就可以了。

参考文档

Content Negotiation using Spring MVC

本文由 arganzheng 创作，采用 CC BY 4.0 许可协议。在保留原文作者、署名以及完整原文链接（https://arganzheng.life/content-negotiation-using-spring-mvc.html）的前提下，欢迎各种形式的转载、翻译或商业引用。

COMMENTS

评论存放在 GitHub Discussions，用 GitHub 账号登录即可发表，支持 Markdown。想针对正文某句话说？选中那段文字，点浮出的「评论」即可划线评论；觉得哪里写错了，发表时勾上「同时提交 Issue」。有人回复你时 GitHub 会按你的通知设置发邮件，不用守在这里。

参考文档

OUTLINE