一个SpringMVC接口能返回JSON又能返回XML? 安排！

我们有一个接口服务为下游的系统提供数据服务，本来好好的大家都愉快地传递JSON，非常和谐。可最近有个新需求去对接一个很老的系统，这倒是不算啥，可这个老系统数据不是以JSON传递的而是以XML传递的。

同事小王想了个馊主意，把原来的接口原版拷贝一遍统一把返回类型改成XML不就行了？嗯，接口路径需要占用一套，权限配置多了一套，还要额外维护一套代码，这主意太馊了。经过大家的研究发现了Spring MVC的某个机制可以满足需求。

原理

在HTTP协议里，当客户端发起一个HTTP请求时，可以携带一个请求头Accept来告诉服务端，客户端可以接受哪些响应类型（MIME），可以是一个也可以是多个。现在前后端分离普遍使用这种：

Accept:application/json

对于Spring MVC框架来说接受到对应的Accept会根据一定的策略找到对应的HttpMessageConverter来处理响应数据的格式。因此我们只需要找到一个动态指定Accept的方法就行了。

内容协商

听起来就很好理解，需要什么内容大家协商，共同解决问题。Spring MVC提供了一种被称作内容协商的机制，客户端在请求时声明需要的MIME类型，服务端只需要配置一些策略就是实现一个接口返回不同MIME类型的数据格式，想要JSON返回JSON,想要XML返回XML。

Spring MVC版本基于Spring MVC 5.3.9。

服务端配置内容协商

内容协商的配置由Spring MVC中的ContentNegotiationManager负责，我们可以通过ContentNegotiationConfigurer配置它。

首先要在Spring MVC项目中加入Jackson的XML处理库：

com.fasterxml.jackson.dataformat

jackson-dataformat-xml

然后配置WebMvcConfigurer中的内容协商配置：

@Configuration

public class WebConfig implements WebMvcConfigurer {

@Override

public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {

configurer.favorParameter(true)

// 客户端请求url需要携带一个query参数 默认名称是 format

.parameterName("format")

// 如果不声明 该query参数 返回的是json  如果你想指定默认返回类型就需要声明

// .defaultContentType(MediaType.APPLICATION_XML)

.mediaType("xml", MediaType.APPLICATION_XML)

.mediaType("json", MediaType.APPLICATION_JSON);

}

}

这样声明以后客户端请求接口中要携带一个query参数（参数名称默认为format，你可以修改它）来指定MIME的代号。根据上面的配置，如果你需要返回JSON:

https://yourapi?format=json

你也可以不携带format参数，因为默认就是JSON，修改默认的MIME类型需要调用defaultContentType。

如果你需要返回XML:

https://yourapi?format=xml

服务端的接口也需要简单的改造：

@GetMapping(value = "/get",produces = {"application/json","application/xml"})

public Map doGet(@RequestParam String foo, String bar) {

Map map = new HashMap<>();

map.put("foo", foo);

map.put("bar", bar);

return map;

}

需要根据配置在@RequestMapping或其简化注解中声明对应的produce，这一点非常重要。这样我们改动的地方就非常的少了，能够适应更多的场景，而且维护起来也很简单。

其它策略

其实Spring MVC的内容协商还可以通过后缀扩展名实现，比如/yourapi.json或者/yourapi.xml。还有直接在客户端请求头中声明MIME类型。这些都不太方便操作所以就不介绍了，有兴趣可以去看官方文档。

OAuth2 服务器Keycloak中的Realm

2021-08-29

架构师必备技能:Maven Archetype生成项目模板

2021-08-28

如果你使用了这个Stream流操作，升级Java17有可能会出问题。

2021-08-26

JSON Spring XML

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。