Jackson 数据格式库 - XML 支持

2026-01-14 18:01:42作者：江焘钦

Jackson 是一个流行的 Java 库，用于处理 JSON 数据。它提供了一套高效、灵活的 API 和模块，可以轻松地序列化和反序列化 JSON 数据。除了 JSON，Jackson 还支持其他数据格式，如 YAML 和 Smile。本文将介绍 Jackson 的一个子项目：jackson-dataformat-xml，它是对 XML 数据的支持。

Jackson-dataformat-xml 简介

Jackson-dataformat-xml 是一个 Jackson 模块，提供了对 XML 数据的序列化和反序列化支持。它使得 Jackson 能够读取、写入 XML 文档，并且能够与现有的 JSON 功能无缝集成。

要开始使用 jackson-dataformat-xml，请首先在您的项目中添加以下依赖：

<!-- Maven -->
<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.14.0</version>
</dependency>

// Gradle
implementation 'com.fasterxml.jackson.dataformat:jackson-dataformat-xml:2.14.0'

使用 Jackson-dataformat-xml 处理 XML

序列化（XML 到 JSON）

要将 Java 对象转换为 XML，您可以使用 ObjectMapper 类，并调用 writeValue() 方法：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

public class Main {
    public static void main(String[] args) throws Exception {
        ObjectMapper xmlMapper = new XmlMapper();

        User user = new User();
        user.setName("Alice");
        user.setEmail("alice@example.com");

        String xml = xmlMapper.writeValueAsString(user);
        System.out.println(xml);
    }
}

class User {
    private String name;
    private String email;

    // getters and setters
}

这将输出以下 XML：

<User>
   <name>Alice</name>
   <email>alice@example.com</email>
</User>

反序列化（JSON 到 XML）

要将 XML 字符串转换回 Java 对象，您需要使用 XmlMapper.readValue() 方法：

String xmlInput = "<User><name>Alice</name><email>alice@example.com</email></User>";

User user = xmlMapper.readValue(xmlInput, User.class);

System.out.println(user.getName()); // 输出 "Alice"
System.out.println(user.getEmail()); // 输出 "alice@example.com"