Spring Boot通过添加jackson-dataformat-xml依赖并使用@XmlRootElement等JAXB注解,可实现对象与XML的自动转换,结合produces和consumes指定application/xml格式,即可在控制器中处理XML请求和响应。

Spring Boot 默认使用 JSON 格式处理请求和响应数据,但通过简单配置也能轻松支持 XML 格式。只要项目中引入了合适的依赖,并正确使用注解,就能实现对象与 XML 之间的自动转换。
添加 Jackson XML 依赖
Spring Boot 使用 Jackson 实现 XML 序列化和反序列化,需在 pom.xml 中引入 jackson-dataformat-xml 依赖:
com.fasterxml.jackson.dataformat jackson-dataformat-xml
引入后,Spring 自动注册 MappingJackson2XmlHttpMessageConverter,用于处理 XML 数据的读写。
实体类添加 JAXB 注解
要让对象能被正确转换为 XML,需要在实体类上添加 JAXB 相关注解:
- @XmlRootElement:标识该类可序列化为根元素
- @XmlElement:可选,用于指定字段对应的 XML 元素名
- @XmlAccessorType(XmlAccessType.FIELD):表示使用字段访问策略
示例:
@XmlRootElement
@XmlAccessorType(XmlAccessType.FIELD)
public class User {
private Long id;
private String name;
private String email;
// 构造方法、getter、setter
}
控制器支持 XML 请求与响应
在 Controller 方法中,通过 produces 和 consumes 指定使用 XML 格式:
- 返回 XML:设置 produces = "application/xml"
- 接收 XML:设置 consumes = "application/xml"
示例代码:
@RestController
public class UserController {
@GetMapping(value = "/user", produces = "application/xml")
public User getUser() {
return new User(1L, "张三", "zhangsan@example.com");
}
@PostMapping(value = "/user", consumes = "application/xml", produces = "application/xml")
public User createUser(@RequestBody User user) {
user.setId(2L); // 模拟保存
return user;
}
}
当客户端发送请求头 Accept: application/xml 或 Content-Type: application/xml 时,Spring Boot 会自动使用 XML 转换器处理数据。
测试 XML 接口
使用 curl 或 Postman 发送请求:
curl -H "Accept: application/xml" http://localhost:8080/user
返回结果:
1 张三 zhangsan@example.com
发送 POST 请求时,确保设置 Content-Type: application/xml 并提供 XML 正文。
基本上就这些。只要依赖到位、注解正确、接口明确指定格式,Spring Boot 处理 XML 数据非常自然。不复杂但容易忽略细节,比如忘了加 @XmlRootElement 就会导致转换失败。










