一、什么是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开发之旅。
