语言： 中文 | English
FASTJSON v2
FASTJSON 2是一个性能极致并且简单易用的Java JSON库。
FASTJSON 2是FASTJSON项目的重要升级，和FASTJSON 1相比，性能有非常大的提升，解决了autoType功能因为兼容和白名单的安全性问题。- 性能极致，性能远超过其他流行JSON库，包括jackson/gson/org.json，性能数据: https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
- 支持JDK新特性，包括
JDK 11/JDK 17，针对compact string优化，支持Record，支持GraalVM Native-Image - 完善的
JSONPath支持，支持SQL:2016的JSONPath语法 - 支持
Android 8+，客户端和服务器一套API - 支持
Kotlinhttps://alibaba.github.io/fastjson2/kotlin_cn - 支持
JSON Schemahttps://alibaba.github.io/fastjson2/json_schema_cn - 新增加支持二进制格式JSONB https://alibaba.github.io/fastjson2/jsonb_format_cn
1. 使用准备
1.1 添加依赖
在fastjson v2中，groupId和1.x不一样，是com.alibaba.fastjson2：
Maven:
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2</artifactId>
<version>2.0.25</version>
</dependency>Gradle:
dependencies {
implementation 'com.alibaba.fastjson2:fastjson2:2.0.25'
}可以在 maven.org 查看最新可用的版本。
1.2 其他模块
Fastjson v1兼容模块
如果原来使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保证100%兼容，请仔细测试验证，发现问题请及时反馈。
Maven:
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>2.0.25</version>
</dependency>Gradle:
dependencies {
implementation 'com.alibaba:fastjson:2.0.25'
}Fastjson Kotlin集成模块
如果项目使用Kotlin，可以使用fastjson-kotlin模块，使用方式上采用kotlin的特性。
Maven:
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2-kotlin</artifactId>
<version>2.0.25</version>
</dependency>
<!-- 有些场景需要依赖kotlin-reflect -->
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-reflect</artifactId>
<version>${kotlin-version}</version>
</dependency>Kotlin Gradle:
dependencies {
implementation("com.alibaba.fastjson2:fastjson2-kotlin:2.0.25")
}Fastjson Extension扩展模块
如果项目使用SpringFramework等框架，可以使用fastjson-extension模块，使用方式参考 SpringFramework Support。
Maven:
<dependency>
<groupId>com.alibaba.fastjson2</groupId>
<artifactId>fastjson2-extension</artifactId>
<version>2.0.25</version>
</dependency>Gradle:
dependencies {
implementation 'com.alibaba.fastjson2:fastjson2-extension:2.0.25'
}2. 简单使用
在fastjson v2中，package和1.x不一样，是com.alibaba.fastjson2。如果你之前用的是fastjson1，大多数情况直接更包名就即可。
2.1 将JSON解析为JSONObject
Java:
String text = "...";
JSONObject data = JSON.parseObject(text);
byte[] bytes = ...;
JSONObject data = JSON.parseObject(bytes);Kotlin:
import com.alibaba.fastjson2.*
val text = ... // String
val data = text.parseObject()
val bytes = ... // ByteArray
val data = bytes.parseObject() // JSONObject2.2 将JSON解析为JSONArray
Java:
String text = "...";
JSONArray data = JSON.parseArray(text);Kotlin:
import com.alibaba.fastjson2.*
val text = ... // String
val data = text.parseArray() // JSONArray2.3 将JSON解析为Java对象
Java:
String text = "...";
User data = JSON.parseObject(text, User.class);Kotlin:
import com.alibaba.fastjson2.*
val text = ... // String
val data = text.to<User>() // User
val data = text.parseObject<User>() // User2.4 将Java对象序列化为JSON
Java:
Object data = "...";
String text = JSON.toJSONString(data);
byte[] text = JSON.toJSONBytes(data);Kotlin:
import com.alibaba.fastjson2.*
val data = ... // Any
val text = text.toJSONString() // String
val bytes = text.toJSONByteArray() // ByteArray2.5 使用JSONObject、JSONArray
2.5.1 获取简单属性
String text = "{\"id\": 2,\"name\": \"fastjson2\"}";
JSONObject obj = JSON.parseObject(text);
int id = obj.getIntValue("id");
String name = obj.getString("name");String text = "[2, \"fastjson2\"]";
JSONArray array = JSON.parseArray(text);
int id = array.getIntValue(0);
String name = array.getString(1);2.5.2 读取JavaBean
Java:
JSONArray array = ...
JSONObject obj = ...
User user = array.getObject(0, User.class);
User user = obj.getObject("key", User.class);Kotlin:
val array = ... // JSONArray
val obj = ... // JSONObject
val user = array.to<User>(0)
val user = obj.to<User>("key")2.5.3 转为JavaBean
Java:
JSONArray array = ...
JSONObject obj = ...
User user = obj.toJavaObject(User.class);
List<User> users = array.toJavaList(User.class);Kotlin:
val array = ... // JSONArray
val obj = ... // JSONObject
val user = obj.to<User>() // User
val users = array.toList<User>() // List<User>2.6 将JavaBean对象序列化为JSON
Java:
class User {
public int id;
public String name;
}
User user = new User();
user.id = 2;
user.name = "FastJson2";
String text = JSON.toJSONString(user);
byte[] bytes = JSON.toJSONBytes(user);Kotlin:
class User(
var id: Int,
var name: String
)
val user = User()
user.id = 2
user.name = "FastJson2"
val text = user.toJSONString() // String
val bytes = user.toJSONByteArray() // ByteArray序列化结果:
{
"id" : 2,
"name" : "FastJson2"
}3. 进阶使用
3.1 使用JSONB
3.1.1 将JavaBean对象序列化JSONB
User user = ...;
byte[] bytes = JSONB.toBytes(user);
byte[] bytes = JSONB.toBytes(user, JSONWriter.Feature.BeanToArray);3.1.2 将JSONB数据解析为JavaBean
byte[] bytes = ...
User user = JSONB.parseObject(bytes, User.class);
User user = JSONB.parseObject(bytes, User.class, JSONReader.Feature.SupportBeanArrayMapping);3.2 使用JSONPath
3.2.1 使用JSONPath读取部分数据
String text = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
JSONReader parser = JSONReader.of(text);
Object result = path.extract(parser);3.2.2 使用JSONPath读取部分byte[]的数据
byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
JSONReader parser = JSONReader.of(bytes);
Object result = path.extract(parser);3.2.3 使用JSONPath读取部分byte[]的数据
byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
JSONReader parser = JSONReader.ofJSONB(bytes); // 注意这里使用ofJSONB方法
Object result = path.extract(parser);
![@dependabot[bot]](https://web.archive.org/web/20230317114858im_/https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}
