引言
在java spring boot项目中处理xml数据是常见的任务，jackson库提供了强大的xml模块（jackson-dataformat-xml）来简化这一过程。然而，对于初学者来说，解析包含多个相同子元素的xml文件，并将其映射到java对象的list中，可能会遇到一些挑战。本文将通过一个具体的案例，详细演示如何正确配置jackson注解，以实现xml列表数据的完整解析。
XML数据结构示例
我们以一个简单的XML文件为例，该文件包含一个cpe-list根元素，其下有多个cpe-item子元素：
xmlread testtitle
目标是将这个XML解析成一个Java对象，其中包含一个CpeItem对象的列表。
定义Java数据模型
首先，我们需要为XML结构中的每个元素定义对应的Java类。
CpeItem 类
cpe-item元素包含一个name属性和一个title子元素。
package com.dependency.demo;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
import lombok.Data;
@Data
@JacksonXmlRootElement(localName = "cpe-item") // 指明根元素名称
public class CpeItem {
@JacksonXmlProperty(localName = "name", isAttribute = true) // 映射为XML属性
private String name;
// 默认映射为同名子元素
private String title;
}CpeItem类的定义相对直观：
- @JacksonXmlRootElement(localName = "cpe-item")：指定该类映射到名为cpe-item的XML元素。
- @JacksonXmlProperty(localName = "name", isAttribute = true)：将Java字段name映射到XML元素的name属性。
- title字段：Jackson会默认将其映射到cpe-item元素下的title子元素。
CpeList 类（关键部分）
cpe-list是XML的根元素，它包含一个CpeItem对象的列表。正确配置这个类是解析成功的关键。
错误的初始尝试及问题分析：
如果CpeList类最初被定义为：
package com.dependency.demo;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
import lombok.Data;
import java.util.ArrayList;
import java.util.List;
@Data
@JacksonXmlRootElement(localName = "cpe-list")
public class CpeList {
@JacksonXmlElementWrapper(localName = "cpe-item") // 错误的用法
private CpeItem cpeItems; // 错误的类型，应为List
}或者即使是private List
正确的CpeList类定义：
云点滴客户关系管理CRM OA系统
下载
云点滴客户解决方案是针对中小企业量身制定的具有简单易用、功能强大、永久免费使用、终身升级维护的智能化客户解决方案。依托功能强大、安全稳定的阿里云平 台，性价比高、扩展性好、安全性高、稳定性好。高内聚低耦合的模块化设计，使得每个模块最大限度的满足需求，相关模块的组合能满足用户的一系列要求。简单 易用的云备份使得用户随时随地简单、安全、可靠的备份客户信息。功能强大的报表统计使得用户大数据分析变的简单，
为了正确解析XML中的所有cpe-item元素到一个列表中，CpeList类需要做如下修改：
package com.dependency.demo;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlElementWrapper;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;
import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlRootElement;
import lombok.Data;
import java.util.List; // 确保导入List
@Data
@JacksonXmlRootElement(localName = "cpe-list")
public class CpeList {
// 关键注解配置
@JacksonXmlElementWrapper(useWrapping = false) // 表示cpe-item不是在一个额外的包装元素内
@JacksonXmlProperty(localName = "cpe-item") // 表示列表中的每个元素都是cpe-item
private List cpeItem; // 字段名可以与localName不同，但保持语义清晰
} 注解解释：
- @JacksonXmlRootElement(localName = "cpe-list")：指定该类映射到名为cpe-list的XML根元素。
- @JacksonXmlElementWrapper(useWrapping = false)：这个注解至关重要。它告诉Jackson，XML中的cpe-item元素并不是被一个额外的父元素（例如
）包裹起来的。相反，它们是直接作为cpe-list的子元素重复出现的。如果XML结构是 ... ... - @JacksonXmlProperty(localName = "cpe-item")：这个注解与@JacksonXmlElementWrapper结合使用，它明确指出列表中每个元素的XML名称是cpe-item。
XML解析控制器
接下来，我们创建一个Spring Boot的RestController来处理HTTP请求，并执行XML解析操作。
package com.dependency.demo;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamException;
import javax.xml.stream.XMLStreamReader;
import java.io.IOException;
import java.io.InputStream;
@RestController
public class XmlController {
@GetMapping("/parse-xml") // 定义一个GET请求路径
CpeList parseCpeListXml() throws XMLStreamException, IOException {
// 从classpath加载XML文件
InputStream xmlResource = XmlController.class.getClassLoader().getResourceAsStream("test.xml");
if (xmlResource == null) {
throw new IOException("XML file 'test.xml' not found in classpath.");
}
// 创建XMLStreamReader
XMLInputFactory xmlInputFactory = XMLInputFactory.newFactory();
XMLStreamReader xmlStreamReader = xmlInputFactory.createXMLStreamReader(xmlResource);
// 创建XmlMapper实例
XmlMapper mapper = new XmlMapper();
// 可选：配置反序列化特性，例如忽略未知属性
mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// 执行XML解析
CpeList cpeList = mapper.readValue(xmlStreamReader, CpeList.class);
// 打印解析结果以验证
if (cpeList != null && cpeList.getCpeItem() != null) {
System.out.println("Parsed CpeList with " + cpeList.getCpeItem().size() + " items:");
for (CpeItem item : cpeList.getCpeItem()) {
System.out.println(" Name: " + item.getName() + ", Title: " + item.getTitle());
}
}
return cpeList;
}
}代码说明：
- @GetMapping("/parse-xml")：将parseCpeListXml方法映射到/parse-xml路径的GET请求。
- getResourceAsStream("test.xml")：从项目的resources目录下加载test.xml文件。请确保test.xml文件存在于src/main/resources目录中。
- XMLInputFactory和XMLStreamReader：Jackson内部使用StAX API进行XML解析，这里显式创建XMLStreamReader是为了演示其工作流程，但Jackson的readValue方法通常可以直接接受InputStream。
- XmlMapper mapper = new XmlMapper();：创建Jackson XML模块的核心解析器。
- mapper.readValue(xmlStreamReader, CpeList.class);：这是执行实际解析的关键行，将XML流反序列化为CpeList对象。
- 打印输出：为了验证解析结果，我们遍历了cpeList中的cpeItem列表并打印了每个元素的名称和标题。
运行与验证
部署并运行Spring Boot应用后，访问http://localhost:8080/parse-xml（假设应用运行在8080端口），你将看到如下输出：
控制台输出示例：
Parsed CpeList with 2 items: Name: John, Title: xmlread Name: Jack, Title: testtitle
HTTP响应体示例：
xmlread testtitle
这表明两个cpe-item元素都被成功解析并存储在了CpeList对象的cpeItem列表中。
注意事项与总结
-
依赖管理： 确保在pom.xml中添加了Jackson XML模块的依赖：
com.fasterxml.jackson.dataformat jackson-dataformat-xml -
@JacksonXmlElementWrapper 的 useWrapping 属性： 这是处理列表类型字段的关键。
- 当列表元素（如cpe-item）直接作为父元素（如cpe-list）的子元素重复出现时，设置useWrapping = false。
- 当列表元素被一个额外的包装元素包裹时（例如
...
- @JacksonXmlProperty 的 localName 属性： 确保它与XML中实际的元素名称匹配。
-
字段类型： 对于要解析为列表的XML元素，Java字段必须声明为List
类型。 - 错误处理： 在实际应用中，应添加更健壮的错误处理机制，例如文件未找到、XML格式错误等。
通过本文的详细指导，您应该能够掌握在Spring Boot中使用Jackson正确解析包含重复子元素的XML文件的方法。理解@JacksonXmlElementWrapper和@JacksonXmlProperty这两个注解的协同作用，是成功处理此类XML解析任务的关键。
