Java Jackson XML模块怎么用 ObjectMapper读写XML

Java中用Jackson XML模块读写XML的核心是直接使用预配置的XmlMapper类，它默认支持常见类型转换，无需手动注册模块；添加Maven依赖后，可序列化对象为XML（支持注解控制根元素、属性等）或反序列化XML为对象（支持文件、字符串等输入源及命名空间）。

Java 中用 Jackson 的 XML 模块（jackson-dataformat-xml）配合 ObjectMapper 读写 XML，核心是把 XmlMapper 当作专用于 XML 的 ObjectMapper 子类来用——它默认就支持常见 Java 类型与 XML 的相互转换，无需手动注册模块。

添加依赖（Maven）

确保项目中引入了 Jackson XML 模块：

创建 XmlMapper 实例

XmlMapper 是 Jackson 提供的专用类，继承自 ObjectMapper，已预配置好 XML 相关功能。推荐直接使用它，而不是对普通 ObjectMapper 手动注册 JacksonXmlModule（后者已过时且易出错）：

• 最简方式：XmlMapper xmlMapper = new XmlMapper();
• 启用缩进输出（美化 XML）：xmlMapper.enable(SerializationFeature.INDENT_OUTPUT);
• 忽略未知字段（反序列化时跳过 XML 中没有对应字段的标签）：xmlMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

Java 对象转 XML（序列化）

要求对象有标准 getter/setter，或用 @JacksonXmlProperty、@JacksonXmlRootElement 等注解控制映射行为：

Teleporthq

一体化AI网站生成器，能够快速设计和部署静态网站

下载

立即学习“Java免费学习笔记（深入）”；

• 基础示例：String xml = xmlMapper.writeValueAsString(user);
• 写入文件：xmlMapper.writeValue(new File("user.xml"), user);
• 若需根元素名与类名不一致，加注解：@JacksonXmlRootElement(localName = "person")
• 控制字段为属性而非子元素：@JacksonXmlProperty(isAttribute = true) private String id;

XML 转 Java 对象（反序列化）

直接调用 readValue 方法即可，支持字符串、InputStream、File 等输入源：

• 从字符串解析：User user = xmlMapper.readValue(xmlString, User.class);
• 从文件解析：User user = xmlMapper.readValue(new File("user.xml"), User.class);
• 若 XML 有命名空间，需启用支持：xmlMapper.configure(FromXmlParser.Feature.USE_NAMESPACE_AWARE_PARSER, true);
• 处理带文本内容的混合结构（如 text），可用 @JacksonXmlText 标记字段

不复杂但容易忽略：默认情况下 XmlMapper 不处理集合的包装标签（如 ...），需用 @JacksonXmlElementWrapper(localName = "users") 显式声明。