如何用@XmlRootElement注解将APPLICATION_XML数据映射到Rest API模型类

你当前的问题核心是XML结构和模型类的层级不匹配——你的请求XML里，x和y是嵌套在<TYPE>节点下的，而你的SomeModel直接把<TYPES>作为根元素，并且把x、y作为自身字段，这就导致Spring无法正确解析XML节点到模型字段。下面是具体的解决步骤：

1. 确认依赖是否正确 #

Spring Boot处理XML请求需要对应的消息转换器，推荐使用Jackson的XML解析器，只需要在pom.xml（Maven）或者build.gradle（Gradle）中添加依赖：

Maven 示例：

<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
</dependency>

如果是Java 9及以上版本，若你想用JAXB（Java原生的XML绑定），还需要额外添加JAXB的API和实现依赖（因为Java 9+移除了Java EE模块）：

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
    <version>2.3.1</version>
    <scope>runtime</scope>
</dependency>

2. 调整模型类结构，匹配XML层级 #

根据你的请求XML结构：

<TYPES>
    <TYPE>
        <x>3</x>
        <y>5</y>
    </TYPE>
</TYPES>

你需要创建两个模型类来对应这个嵌套结构：

• 一个根类对应<TYPES>节点，内部包含一个对应<TYPE>的子对象
• 一个子类对应<TYPE>节点，包含x和y字段

代码示例：

// 根模型类：对应<TYPES>节点
@Data
@XmlRootElement(name = "TYPES") // 指定根节点名称
public class SomeModel {
    // 绑定<TYPE>子节点到typeDetails字段
    @XmlElement(name = "TYPE")
    private TypeDetails typeDetails;
}

// 子模型类：对应<TYPE>节点
@Data
public class TypeDetails {
    // 字段名和XML节点名一致，无需额外注解
    private String x;
    private String y;
}

如果你的XML里<TYPES>下有多个<TYPE>节点（比如列表），只需要把typeDetails改成List类型即可：

@XmlElement(name = "TYPE")
private List<TypeDetails> typeDetailsList;

3. 控制器代码保持不变 #

你的控制器代码不需要修改，Spring会自动通过消息转换器将XML请求体映射到调整后的SomeModel对象：

@PostMapping(value = "test/{id}/updateSome", consumes = { MediaType.APPLICATION_XML })
public ResponseEntity<String> updateSome(@PathVariable String id, @RequestBody SomeModel reqBody) {
    // 现在可以正常获取嵌套字段：reqBody.getTypeDetails().getX()
    String xValue = reqBody.getTypeDetails().getX();
    String yValue = reqBody.getTypeDetails().getY();
    // 后续业务逻辑...
    return ResponseEntity.ok("Updated successfully");
}

额外注意事项 #

• 模型类必须是public的，如果是内部类，必须标记为static（否则Spring无法反射实例化）
• XML节点名称和注解中的名称是大小写敏感的，一定要完全匹配
• 如果字段名和XML节点名不一致，可以通过@XmlElement(name = "节点名称")指定映射关系（比如字段是xValue，XML节点是x，就写@XmlElement(name = "x") private String xValue;）

内容的提问来源于stack exchange，提问作者USM