SpringBoot中扩展XML请求与响应的支持详解

SpringBoot中扩展XML请求与响应的⽀持详解
前⾔
在之前的所有Spring Boot教程中，我们都只提到和⽤到了针对HTML和JSON格式的请求与响应处理。

那么对于XML格式的请求要如何快速的在Controller中包装成对象，以及如何以XML的格式返回⼀个对象呢？
什么是xml⽂件格式
我们要给对⽅传输⼀段数据，数据内容是“too young,too simple,sometimes naive”，要将这段话按照属性拆分为三个数据的话，就是，年龄too young，阅历too simple，结果sometimes naive。

我们都知道程序不像⼈，可以体会字⾯意思，并⾃动拆分出数据，因此，我们需要帮助程序做拆分，因此出现了各种各样的数据格式以及拆分⽅式。

⽐如，可以是这样的数据为“too young,too simple,sometimes naive”然后按照逗号拆分，第⼀部分为年龄，第⼆部分为阅历，第三部分为结果。

也可以是这样的数据为“too_young* too_simple*sometimes_naive”从数据开头开始截取前⾯⼗⼀个字符，去掉号并把下划线替换为空格作为第⼀部分，再截取接下来的⼗⼀个字符同样去掉并替换下划线为空格作为第⼆部分，最后把剩下的字符同样去号体会空格作为第三部分。

这两种⽅式都可以⽤来容纳数据并能够被解析，但是不直观，通⽤性也不好，⽽且如果出现超过限定字数的字符串就容纳不了，也可能出现数据本⾝就下划线字符导致需要做转义。

基于这种情况，出现了xml这种数据格式，上⾯的数据⽤XML表⽰的话可以是这样
实现原理：消息转换器（Message Converter）
在扩展上述问题之前，我们先要知道Spring Boot中处理HTTP请求的实现是采⽤的Spring MVC。

⽽在Spring MVC中有⼀个消息转换器这个概念，它主要负责处理各种不同格式的请求数据进⾏处理，并包转换成对象，以提供更好的编程体验。

在Spring MVC中定义了HttpMessageConverter接⼝，抽象了消息转换器对类型的判断、对读写的判断与操作，具体可见如下定义：
public interface HttpMessageConverter<T> {
boolean canRead(Class<?> clazz, @Nullable MediaType mediaType);
boolean canWrite(Class<?> clazz, @Nullable MediaType mediaType);
List<MediaType> getSupportedMediaTypes();
T read(Class<? extends T> clazz, HttpInputMessage inputMessage) throws IOException, HttpMessageNotReadableException;
void write(T t, @Nullable MediaType contentType, HttpOutputMessage outputMessage) throws IOException, HttpMessageNotWritableException;
}
众所周知，HTTP请求的Content-Type有各种不同格式定义，如果要⽀持Xml格式的消息转换，就必须要使⽤对应的转换器。

Spring MVC中默认已经有⼀套采⽤Jackson实现的转换器MappingJackson2XmlHttpMessageConverter。

扩展实现
第⼀步：引⼊Xml消息转换器
在传统Spring应⽤中，我们可以通过如下配置加⼊对Xml格式数据的消息转换实现：
@Configuration
public class MessageConverterConfig1 extends WebMvcConfigurerAdapter {
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
Jackson2ObjectMapperBuilder builder = Jackson2ObjectMapperBuilder.xml();
builder.indentOutput(true);
converters.add(new MappingJackson2XmlHttpMessageConverter(builder.build()));
}
}
在Spring Boot应⽤不⽤像上⾯这么⿇烦，只需要加⼊jackson-dataformat-xml依赖，Spring Boot就会⾃动引⼊MappingJackson2XmlHttpMessageConverter的实现：
<dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-xml</artifactId>
</dependency>
同时，为了配置Xml数据与维护对象属性的关系所要使⽤的注解也在上述依赖中，所以这个依赖也是必须的。

第⼆步：定义对象与Xml的关系
做好了基础扩展之后，下⾯就可以定义Xml内容对应的Java对象了，⽐如：
@Data
@NoArgsConstructor
@AllArgsConstructor
@JacksonXmlRootElement(localName = "User")
public class User {
@JacksonXmlProperty(localName = "name")
private String name;
@JacksonXmlProperty(localName = "age")
private Integer age;
}
其中：@Data、@NoArgsConstructor、@AllArgsConstructor是lombok简化代码的注解，主要⽤于⽣成get、set以及构造函数。

@JacksonXmlRootElement、@JacksonXmlProperty注解是⽤来维护对象属性在xml中的对应关系。

上述配置的User对象，其可以映射的Xml样例如下（后续可以使⽤上述xml来请求接⼝）：
<User>
<name>aaaa</name>
<age>10</age>
</User>
第三步：创建接收xml请求的接⼝
完成了要转换的对象之后，可以编写⼀个接⼝来接收xml并返回xml，⽐如：
@Controller
public class UserController {
@PostMapping(value = "/user",
consumes = MediaType.APPLICATION_XML_VALUE,
produces = MediaType.APPLICATION_XML_VALUE)
@ResponseBody
public User create(@RequestBody User user) {
user.setName(" : " + user.getName());
user.setAge(user.getAge() + 100);
return user;
}
}
最后，启动Spring Boot应⽤，通过POSTMAN等请求⼯具，尝试⼀下这个接⼝，可以看到请求Xml，并且返回了经过处理后的Xml内容。

案例代码
可以通过下⾯两个仓库中查阅chapter3-1-8⽬录：
Github
Gitee
本地下载
总结
以上就是这篇⽂章的全部内容了，希望本⽂的内容对⼤家的学习或者⼯作具有⼀定的参考学习价值，如果有疑问⼤家可以留⾔交流，谢谢⼤家对的⽀持。