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 依赖:
<dependency> <groupId>com.fasterxml.jackson.dataformat</groupId> <artifactId>jackson-dataformat-xml</artifactId> </dependency>
引入后,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 -H "Accept: application/xml" http://localhost:8080/user
返回结果:
<User> <id>1</id> <name>张三</name> <email>zhangsan@example.com</email> </User>
发送 POST 请求时,确保设置 Content-Type: application/xml 并提供 XML 正文。
基本上就这些。只要依赖到位、注解正确、接口明确指定格式,Spring Boot 处理 XML 数据非常自然。不复杂但容易忽略细节,比如忘了加 @XmlRootElement 就会导致转换失败。