jackson怎么转换json字符串

Jackson轻松转换JSON字符串：从入门到实用技巧

在Java开发中，处理JSON数据是一项常见任务，而Jackson库凭借其强大的功能和高效的性能，成为了开发者的首选工具之一，本文将详细介绍如何使用Jackson库来转换JSON字符串，包括基本操作、高级配置以及常见问题的解决方案。

Jackson简介

Jackson是一个开源的Java库，用于处理JSON数据，它提供了一系列API，可以将Java对象序列化为JSON字符串，也可以将JSON字符串反序列化为Java对象,Jackson主要由三个模块组成：

1. jackson-core：核心JSON处理包
2. jackson-databind：数据绑定包，提供ObjectMapper类
3. jackson-annotations：注解支持包

环境准备

在使用Jackson之前，需要先添加相关依赖，以Maven为例，在pom.xml中添加以下依赖：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- 使用最新版本 -->
</dependency>

基本JSON字符串转换操作

JSON字符串转Java对象（反序列化）

假设我们有以下JSON字符串：

{"name":"张三","age":30,"city":"北京"}

对应的Java类：

public class Person {
    private String name;
    private int age;
    private String city;
    // getters和setters
    // toString()方法
}

转换代码：

import com.fasterxml.jackson.databind.ObjectMapper;
public class JsonToJava {
    public static void main(String[] args) throws Exception {
        String jsonStr = "{\"name\":\"张三\",\"age\":30,\"city\":\"北京\"}";
        ObjectMapper objectMapper = new ObjectMapper();
        Person person = objectMapper.readValue(jsonStr, Person.class);
        System.out.println(person);
    }
}

Java对象转JSON字符串（序列化）

import com.fasterxml.jackson.databind.ObjectMapper;
public class JavaToJson {
    public static void main(String[] args) throws Exception {
        Person person = new Person();
        person.setName("李四");
        person.setAge(25);
        person.setCity("上海");
        ObjectMapper objectMapper = new ObjectMapper();
        String jsonStr = objectMapper.writeValueAsString(person);
        System.out.println(jsonStr);
    }
}

处理复杂数据结构

处理JSON数组

[
    {"name":"张三","age":30},
    {"name":"李四","age":25}
]

转换为List：

String jsonArrayStr = "[{\"name\":\"张三\",\"age\":30},{\"name\":\"李四\",\"age\":25}]";
ObjectMapper objectMapper = new ObjectMapper();
List<Person> personList = objectMapper.readValue(jsonArrayStr, 
    new TypeReference<List<Person>>() {});
System.out.println(personList);

处理嵌套JSON

{
    "name":"王五",
    "address":{
        "city":"广州",
        "street":"天河路123号"
    }
}

对应的Java类：

public class Address {
    private String city;
    private String street;
    // getters和setters
}
public class PersonWithAddress {
    private String name;
    private Address address;
    // getters和setters
}

转换方式与简单对象相同,ObjectMapper会自动处理嵌套关系。

常用配置与注解

ObjectMapper配置

ObjectMapper objectMapper = new ObjectMapper();
// 忽略未知属性
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// 美化输出
objectMapper.enable(SerializationFeature.INDENT_OUTPUT);
// 处理日期格式
objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));

常用Jackson注解

• @JsonProperty: 指定JSON字段与Java属性的映射关系
• @JsonIgnore: 忽略该属性
• @JsonFormat: 格式化日期等字段
• @JsonCreator: 用于自定义构造函数反序列化

示例：

public class Person {
    @JsonProperty("user_name")
    private String name;
    @JsonIgnore
    private String password;
    @JsonFormat(pattern = "yyyy-MM-dd")
    private Date birthDate;
    @JsonCreator
    public Person(@JsonProperty("name") String name) {
        this.name = name;
    }
    // 其他代码
}

常见问题与解决方案

处理日期类型

默认情况下，Jackson会将日期序列化为时间戳，可以使用@JsonFormat注解指定格式：

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date createTime;

处理枚举类型

public enum Gender {
    MALE, FEMALE
}
public class Person {
    private Gender gender;
    // getters和setters
}

JSON字符串中可以使用枚举名称或自定义值：

// 使用枚举名称
{"gender":"MALE"}
// 使用@JsonValue自定义序列化值
public enum Gender {
    MALE("男"), FEMALE("女");
    private String value;
    Gender(String value) {
        this.value = value;
    }
    @JsonValue
    public String getValue() {
        return value;
    }
}

处理循环引用

使用@JsonManagedReference和@JsonBackReference解决循环引用问题：

public class Person {
    private String name;
    @JsonManagedReference
    private List<Person> friends;
    // getters和setters
}
public class Main {
    public static void main(String[] args) throws Exception {
        Person person1 = new Person();
        person1.setName("张三");
        Person person2 = new Person();
        person2.setName("李四");
        List<Person> friends = new ArrayList<>();
        friends.add(person2);
        person1.setFriends(friends);
        ObjectMapper objectMapper = new ObjectMapper();
        // 防止循环引用导致的无限递归
        objectMapper.enable(SerializationFeature.INDENT_OUTPUT);
        objectMapper.configure(SerializationFeature.FAIL_ON_SELF_REFERENCES, false);
        String jsonStr = objectMapper.writeValueAsString(person1);
        System.out.println(jsonStr);
    }
}

性能优化建议

1. 重用ObjectMapper实例：ObjectMapper是线程安全的，可以全局重用
2. 使用JsonParser和JsonGenerator：对于高性能场景，可以直接使用底层API
3. 启用合适的功能：根据需要启用或禁用特定功能
4. 避免过度使用注解：过多的注解可能会影响性能

Jackson库提供了强大而灵活的JSON处理能力，通过本文的介绍，相信你已经了如何使用Jackson进行JSON字符串与Java对象之间的转换，从基本的序列化和反序列化，到处理复杂数据结构和配置选项，Jackson都能满足各种开发需求，在实际开发中，合理使用Jackson的特性和配置,可以大大提高开发效率和程序性能。

实践是最好的学习方式，尝试在实际项目中应用这些技巧，你会发现Jackson确实是Java JSON处理的利器。