FASTJSON 2.0介绍

0. FASTJSON 2.0介绍

FASTJSON v2是FASTJSON项目的重要升级，目标是为下一个十年提供一个高性能的JSON库。通过同一套API，

支持JSON/JSONB两种协议，JSONPath 是一等公民。

支持全量解析和部分解析。

支持Java服务端、客户端Android、大数据场景。

支持Kotlin

支持JSON Schema https://alibaba.github.io/fastjson2/JSONSchema/json_schema_cn

支持Android

支持Graal Native-Image

相关文档：

JSONB格式文档：

https://alibaba.github.io/fastjson2/JSONB/jsonb_format_cn

FASTJSON v2性能有了很大提升，具体性能数据看这里：

https://alibaba.github.io/fastjson2/benchmark_cn

1. 使用准备

1.1 添加依赖

在fastjson v2中，groupId和1.x不一样，是com.alibaba.fastjson2：

Maven:

com.alibaba.fastjson2

fastjson2

2.0.60

Gradle:

dependencies {

implementation 'com.alibaba.fastjson2:fastjson2:2.0.60'

}

可以在 maven.org 查看最新可用的版本。

1.2 其他模块

Fastjson v1兼容模块

如果原来使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保证100%兼容，请仔细测试验证，发现问题请及时反馈。

Maven:

com.alibaba

fastjson

2.0.60

Gradle:

dependencies {

implementation 'com.alibaba:fastjson:2.0.60'

}

Fastjson Kotlin集成模块

如果项目使用Kotlin，可以使用fastjson-kotlin模块，使用方式上采用kotlin的特性。

Maven:

com.alibaba.fastjson2

fastjson2-kotlin

2.0.60

Gradle:

dependencies {

implementation("com.alibaba.fastjson2:fastjson2-kotlin:2.0.60")

}

Fastjson Extension扩展模块

如果项目使用SpringFramework等框架，可以使用fastjson-extension模块，使用方式参考 SpringFramework Support。

Maven:

com.alibaba.fastjson2

fastjson2-extension

2.0.60

Gradle:

dependencies {

implementation 'com.alibaba.fastjson2:fastjson2-extension:2.0.60'

}

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() // JSONObject

2.2 将JSON解析为JSONArray

Java:

String text = "...";

JSONArray data = JSON.parseArray(text);

Kotlin:

import com.alibaba.fastjson2.*

val text = ... // String

val data = text.parseArray() // JSONArray

2.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

val data = text.parseObject() // User

2.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 = data.toJSONString() // String

val bytes = data.toJSONByteArray() // ByteArray

2.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.getObject(0)

val user = obj.getObject("key")

2.5.3 转为JavaBean

Java:

JSONArray array = ...

JSONObject obj = ...

User user = obj.toJavaObject(User.class);

List users = array.toJavaList(User.class);

Kotlin:

val array = ... // JSONArray

val obj = ... // JSONObject

val user = obj.toObject() // User

val users = array.toList() // List

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);