FastJson详解与使用：高效JSON解析与序列化利器

一休哥助手

于 2024-10-05 09:00:00 发布

阅读量471

点赞数 7

文章标签： json 开发语言

本文链接：https://blog.csdn.net/fudaihb/article/details/142640800

版权

一、什么是FastJson？

FastJson是阿里巴巴开源的一个高效Java JSON解析库，支持JSON数据的序列化和反序列化。它不仅能将Java对象与JSON字符串互相转换，还支持复杂的对象嵌套和自定义序列化策略。此外，FastJson还具备较高的性能优势，特别适用于对性能要求较高的场景。

1.1 FastJson的特性

高性能：相比于Gson和Jackson，FastJson在JSON处理上拥有更快的解析速度和更低的内存占用。
易用性：API设计简单，易于上手。
灵活的配置：支持自定义序列化和反序列化，灵活应对复杂场景。
丰富的功能：支持Java对象与JSON字符串的双向转换、格式化输出、注解驱动等多种功能。

二、FastJson的安装

在项目中使用FastJson非常简单，首先需要在Maven项目的pom.xml中添加FastJson的依赖。

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>

如果使用Gradle，可以这样添加依赖：

implementation 'com.alibaba:fastjson:1.2.83'

三、FastJson的基本使用

3.1 Java对象序列化为JSON字符串

将Java对象转换为JSON字符串是FastJson最常见的功能。可以通过JSON.toJSONString()方法轻松实现。

import com.alibaba.fastjson.JSON;

public class FastJsonExample {
    public static void main(String[] args) {
        User user = new User(1, "张三", 28);
        String jsonString = JSON.toJSONString(user);
        System.out.println(jsonString);
    }
}

class User {
    private int id;
    private String name;
    private int age;

    // 构造函数、getter和setter方法
}

输出的JSON字符串如下：

{"age":28,"id":1,"name":"张三"}

3.2 JSON字符串反序列化为Java对象

使用JSON.parseObject()方法可以将JSON字符串反序列化为Java对象。

import com.alibaba.fastjson.JSON;

public class FastJsonExample {
    public static void main(String[] args) {
        String jsonString = "{\"age\":28,\"id\":1,\"name\":\"张三\"}";
        User user = JSON.parseObject(jsonString, User.class);
        System.out.println(user.getName());
    }
}

输出结果：

张三

3.3 序列化复杂对象

FastJson支持嵌套对象和集合类型的序列化与反序列化。例如，以下代码展示了序列化包含集合的对象。

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

public class FastJsonExample {
    public static void main(String[] args) {
        Order order = new Order(101, List.of(new Item("电脑", 5000), new Item("手机", 2000)));
        String jsonString = JSON.toJSONString(order);
        System.out.println(jsonString);
    }
}

class Order {
    private int orderId;
    private List<Item> items;
    
    // 构造函数、getter和setter方法
}

class Item {
    private String name;
    private double price;
    
    // 构造函数、getter和setter方法
}

生成的JSON字符串将包含嵌套的集合：

{"items":[{"name":"电脑","price":5000},{"name":"手机","price":2000}],"orderId":101}

3.4 反序列化复杂对象

反序列化复杂对象需要使用TypeReference来指定类型信息。

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

public class FastJsonExample {
    public static void main(String[] args) {
        String jsonString = "[{\"name\":\"电脑\",\"price\":5000},{\"name\":\"手机\",\"price\":2000}]";
        List<Item> items = JSON.parseObject(jsonString, new TypeReference<List<Item>>() {});
        System.out.println(items.get(0).getName());
    }
}

四、FastJson注解详解

FastJson提供了一系列注解，用于控制序列化和反序列化的行为，以下是一些常用注解的介绍。

4.1 `@JSONField`

@JSONField注解用于自定义属性在序列化和反序列化过程中的表现。它可以设置字段名、格式化规则等。

示例1：更改字段名

import com.alibaba.fastjson.annotation.JSONField;

public class User {
    private int id;
    
    @JSONField(name = "user_name")
    private String name;
    
    private int age;

    // 构造函数、getter和setter方法
}

序列化后的JSON字段名将变为user_name：

{"age":28,"id":1,"user_name":"张三"}

示例2：格式化日期

import com.alibaba.fastjson.annotation.JSONField;
import java.util.Date;

public class Event {
    private String title;
    
    @JSONField(format = "yyyy-MM-dd HH:mm:ss")
    private Date eventDate;

    // 构造函数、getter和setter方法
}

输出的JSON字符串中，日期将按照指定格式输出：

{"eventDate":"2023-09-25 14:35:00","title":"会议"}

4.2 `@JSONType`

@JSONType注解用于类级别的控制，可以指定序列化时的顺序、忽略字段等。

import com.alibaba.fastjson.annotation.JSONType;

@JSONType(orders = {"name", "id"})
public class User {
    private int id;
    private String name;
    private int age;

    // 构造函数、getter和setter方法
}

序列化后的JSON将按照指定顺序输出：

{"name":"张三","id":1,"age":28}

五、FastJson的高级功能

5.1 解析JSON数组

FastJson可以轻松解析JSON数组为Java集合。使用parseArray()方法即可实现。

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

public class FastJsonExample {
    public static void main(String[] args) {
        String jsonString = "[{\"age\":28,\"id\":1,\"name\":\"张三\"},{\"age\":25,\"id\":2,\"name\":\"李四\"}]";
        List<User> users = JSON.parseArray(jsonString, User.class);
        System.out.println(users.get(1).getName());
    }
}

5.2 JSON Path

FastJson支持类似于XPath的JSON路径表达式，通过JSONPath类，可以直接从JSON中提取所需的部分数据。

import com.alibaba.fastjson.JSONPath;

public class FastJsonExample {
    public static void main(String[] args) {
        String jsonString = "{\"store\":{\"book\":[{\"category\":\"fiction\",\"price\":10.99},{\"category\":\"non-fiction\",\"price\":12.99}]}}";
        Object result = JSONPath.eval(JSON.parseObject(jsonString), "$.store.book[0].price");
        System.out.println(result);  // 输出：10.99
    }
}

5.3 序列化过滤器

FastJson允许开发者通过实现自定义过滤器来控制序列化行为。常见的过滤器包括PropertyFilter、ValueFilter等。

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

public class FastJsonExample {
    public static void main(String[] args) {
        User user = new User(1, "张三", 28);
        
        PropertyFilter filter = (object, name, value) -> !"age".equals(name);
        
        String jsonString = JSON.toJSONString(user, filter);
        System.out.println(jsonString);  // 输出不包含age字段
    }
}

六、FastJson的性能优化

使用合适的解析方法：JSON.parseObject()和JSON.parseArray()的性能优于JSON.parse()，因为前者明确指定了目标类型，解析时减少了类型推断的开销。
关闭循环引用检测：

对于大对象树结构，可以关闭循环引用检测来提升性能：

```java
JSON.toJSONString(object, SerializerFeature.DisableCircularReferenceDetect);
```

缓存解析器：对于多次使用的JSON结构，可以缓存反序列化的结果，以减少重复解析的开销。

七、结语

FastJson作为Java开发中处理JSON数据的利器，凭借其高效的性能、灵活的配置和丰富的功能，深受广大开发者的喜爱。本文详细介绍了FastJson的基础用法、注解配置及高级功能，并给出了性能优化的建议。在实际项目中，合理使用FastJson能够极大地提高JSON数据处理的效率。希望本文能够帮助你更好地理解和掌握FastJson，助力你的Java开发之旅。