Java中如何使用Jackson实现对象、Json、Xml的相互转换

在Java后端开发中，数据在不同系统间传输时经常会用到Json和Xml格式，Jackson作为轻量且高效的序列化工具，能够很方便地实现Java对象、Json、Xml三者的相互转换，不需要开发者手动处理复杂的格式解析逻辑。

Jackson核心依赖引入

要使用Jackson实现三种格式的转换，需要在项目中引入对应的依赖，如果是Maven项目，在pom.xml中添加以下配置即可：

<!-- Jackson核心基础依赖 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>
<!-- Jackson Xml转换依赖 -->
<dependency>
    <groupId>com.fasterxml.jackson.dataformat</groupId>
    <artifactId>jackson-dataformat-xml</artifactId>
    <version>2.15.2</version>
</dependency>

Java对象与Json的相互转换

Jackson的ObjectMapper类是处理Json转换的核心类，通过它可以快速实现对象转Json和Json转对象。

对象转Json

首先定义一个简单的Java实体类作为示例：

public class User {
    private String name;
    private Integer age;
    private String email;

    // 必须提供无参构造，Jackson反序列化需要
    public User() {}

    public User(String name, Integer age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }

    // getter和setter方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public String getEmail() { return email; }
    public void setEmail(String email) { this.email = email; }
}

转换代码如下：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;

public class JsonDemo {
    public static void main(String[] args) throws JsonProcessingException {
        // 创建ObjectMapper实例
        ObjectMapper objectMapper = new ObjectMapper();
        // 创建测试对象
        User user = new User("张三", 25, "zhangsan@ipipp.com");
        // 对象转Json字符串
        String jsonStr = objectMapper.writeValueAsString(user);
        System.out.println("对象转Json结果：" + jsonStr);
    }
}

Json转对象

同样的ObjectMapper也可以实现Json字符串转Java对象：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;

public class JsonDemo {
    public static void main(String[] args) throws JsonProcessingException {
        ObjectMapper objectMapper = new ObjectMapper();
        String jsonStr = "{\"name\":\"李四\",\"age\":30,\"email\":\"lisi@ipipp.com\"}";
        // Json转对象
        User user = objectMapper.readValue(jsonStr, User.class);
        System.out.println("Json转对象结果，姓名：" + user.getName() + "，年龄：" + user.getAge());
    }
}

Java对象与Xml的相互转换

处理Xml转换需要使用Jackson的XmlMapper类，它是ObjectMapper的子类，专门用于Xml格式的序列化。

对象转Xml

如果实体类字段需要自定义Xml标签名，可以添加@JacksonXmlProperty注解：

import com.fasterxml.jackson.dataformat.xml.annotation.JacksonXmlProperty;

public class User {
    @JacksonXmlProperty(localName = "userName")
    private String name;
    private Integer age;
    @JacksonXmlProperty(localName = "userEmail")
    private String email;

    public User() {}

    public User(String name, Integer age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }

    // getter和setter方法省略
}

转换代码如下：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

public class XmlDemo {
    public static void main(String[] args) throws JsonProcessingException {
        // 创建XmlMapper实例
        XmlMapper xmlMapper = new XmlMapper();
        User user = new User("王五", 28, "wangwu@ipipp.com");
        // 对象转Xml字符串
        String xmlStr = xmlMapper.writeValueAsString(user);
        System.out.println("对象转Xml结果：\n" + xmlStr);
    }
}

Xml转对象

Xml转对象的代码和Json转对象逻辑类似，只是使用XmlMapper的readValue方法：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.dataformat.xml.XmlMapper;

public class XmlDemo {
    public static void main(String[] args) throws JsonProcessingException {
        XmlMapper xmlMapper = new XmlMapper();
        String xmlStr = "<User><userName>赵六</userName><age>32</age><userEmail>zhaoliu@ipipp.com</userEmail></User>";
        // Xml转对象
        User user = xmlMapper.readValue(xmlStr, User.class);
        System.out.println("Xml转对象结果，姓名：" + user.getName() + "，年龄：" + user.getAge());
    }
}

常用配置与注意事项

• 如果实体类没有无参构造，Jackson反序列化时会报错，需要手动添加无参构造或者使用@JsonCreator注解指定构造方法。
• 处理日期类型时，可以通过@JsonFormat注解指定日期格式，比如@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")，避免日期转换出现格式错误。
• 如果对象中有不需要序列化的字段，可以添加@JsonIgnore注解，该字段在转Json或Xml时会被忽略。
• Xml转换时默认根标签是类名，可以通过@JacksonXmlRootElement注解自定义根标签名称。

JacksonJson转换Xml转换Java对象序列化修改时间：2026-06-06 14:51:19