使用FastJson

使用FastJson | AI生成和翻译

Home 2025.03

FastJSON 是阿里巴巴开发的高性能 Java JSON 处理库，广泛用于将 JSON 字符串解析为 Java 对象、将 Java 对象序列化为 JSON 以及高效处理 JSON 数据。以下是根据其核心功能使用 FastJSON 的指南。

第一步：将 FastJSON 添加到项目

要使用 FastJSON，需要将其引入项目。如果使用 Maven，请在 pom.xml 中添加以下依赖：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>2.0.51</version> <!-- 请使用可用的最新版本 -->
</dependency>

如果使用 Gradle，请在 build.gradle 中添加：

implementation 'com.alibaba:fastjson:2.0.51'

请在 Maven 中央仓库查看最新版本。

第二步：基本用法

以下是使用 FastJSON 进行序列化和反序列化等常见任务的方法。

1. 将 Java 对象序列化为 JSON

使用 JSON.toJSONString() 将 Java 对象转换为 JSON 字符串。

import com.alibaba.fastjson.JSON;

public class Main {
    public static void main(String[] args) {
        // 创建示例对象
        User user = new User("Alice", 25);
        
        // 序列化为 JSON 字符串
        String jsonString = JSON.toJSONString(user);
        System.out.println(jsonString);
    }
}

// 示例 User 类
class User {
    private String name;
    private int age;

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

    // Getter 和 Setter（FastJSON 正常工作所需）
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
}

输出：

{"age":25,"name":"Alice"}

2. 将 JSON 反序列化为 Java 对象

使用 JSON.parseObject() 将 JSON 字符串解析回 Java 对象。

import com.alibaba.fastjson.JSON;

public class Main {
    public static void main(String[] args) {
        String jsonString = "{\"age\":25,\"name\":\"Alice\"}";
        
        // 反序列化为 User 对象
        User user = JSON.parseObject(jsonString, User.class);
        System.out.println("Name: " + user.getName() + ", Age: " + user.getAge());
    }
}

输出：

Name: Alice, Age: 25

3. 将 JSON 解析为列表

如果 JSON 表示对象列表，请使用 JSON.parseArray()。

import com.alibaba.fastjson.JSON;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        String jsonArray = "[{\"name\":\"Alice\",\"age\":25},{\"name\":\"Bob\",\"age\":30}]";
        
        // 反序列化为 List<User>
        List<User> users = JSON.parseArray(jsonArray, User.class);
        for (User user : users) {
            System.out.println("Name: " + user.getName() + ", Age: " + user.getAge());
        }
    }
}

输出：

Name: Alice, Age: 25
Name: Bob, Age: 30

第三步：高级功能

FastJSON 提供额外的自定义选项：

1. 自定义序列化

使用 SerializerFeature 选项控制字段的序列化方式。

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;

public class Main {
    public static void main(String[] args) {
        User user = new User("Alice", 25);
        
        // 使用 PrettyFormat 生成可读性强的输出
        String jsonString = JSON.toJSONString(user, SerializerFeature.PrettyFormat);
        System.out.println(jsonString);
    }
}

输出：

{
	"age":25,
	"name":"Alice"
}

常用 SerializerFeature 选项：

WriteNullListAsEmpty：空列表输出为 [] 而非 null。
WriteMapNullValue：在输出中包含值为 null 的字段。

2. 处理复杂对象

对于嵌套对象，请确保内部类具有正确的 getter/setter 方法。

import com.alibaba.fastjson.JSON;

public class Main {
    public static void main(String[] args) {
        Address address = new Address("123 Main St", "NY");
        User user = new User("Alice", 25, address);
        
        String jsonString = JSON.toJSONString(user);
        System.out.println(jsonString);

        User parsedUser = JSON.parseObject(jsonString, User.class);
        System.out.println(parsedUser.getAddress().getCity());
    }
}

class User {
    private String name;
    private int age;
    private Address address;

    public User(String name, int age, Address address) {
        this.name = name;
        this.age = age;
        this.address = address;
    }

    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public int getAge() { return age; }
    public void setAge(int age) { this.age = age; }
    public Address getAddress() { return address; }
    public void setAddress(Address address) { this.address = address; }
}

class Address {
    private String street;
    private String city;

    public Address(String street, String city) {
        this.street = street;
        this.city = city;
    }

    public String getStreet() { return street; }
    public void setStreet(String street) { this.street = street; }
    public String getCity() { return city; }
    public void setCity(String city) { this.city = city; }
}

输出：

{"address":{"city":"NY","street":"123 Main St"},"age":25,"name":"Alice"}
NY

第四步：注意事项与最佳实践

安全性：旧版 FastJSON 存在漏洞（例如远程代码执行）。请始终使用最新版本，除非必要避免启用 Feature.SupportAutoType。
性能：FastJSON 针对速度进行了优化，但对于大型数据集，请根据具体使用场景进行测试。
文档：更多详细信息请参阅官方 FastJSON GitHub 页面。

如有特定使用场景或故障排除需求，请随时告知！

Back Donate