1. FASTJSON v2介绍

FASTJSON v2是FASTJSON项目的重要升级，目标是为下一个十年提供一个高性能的JSON库。通过同一套API支持JSON/JSONB两种协议，JSONPath是一等公民，支持全量解析和部分解析，支持Java服务端、客户端Android、大数据场景。

FASTJSON v2代码 https://github.com/alibaba/fastjson2/releases

JSONB格式文档 https://github.com/alibaba/fastjson2/wiki/jsonb_format_cn

FASTJSON v2性能有了更大提升，具体性能数据看这里 https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark

更多相关文档 https://github.com/alibaba/fastjson2/wiki

2. 使用前准备

2.1 Maven依赖

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

com.alibaba.fastjson2

fastjson2

2.x.x

可以在

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

2.2 fastjson v1的兼容包

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

com.alibaba

fastjson

2.x.x

2.3 常用类和方法

在fastjson v2中，package和1.x不一样，是com.alibaba.fastjson2。如果你之前用的是fastjson1，大多数情况直接更包名就即可。

package com.alibaba.fastjson2;

class JSON {

// 将字符串解析成JSONObject

static JSONObject parseObject(String str);

// 将字符串解析成JSONArray

static JSONArray parseArray(String str);

// 将字符串解析成Java对象

static T parseObject(byte[] utf8Bytes, Class objectClass);

// 将Java对象输出成字符串

static String toJSONString(Object object);

// 将Java对象输出成UTF8编码的byte[]

static byte[] toJSONBytes(Object object);

}

class JSONB {

// 将jsonb格式的byte[]解析成Java对象

static T parseObject(byte[] jsonbBytes, Class objectClass);

// 将Java对象输出成jsonb格式的byte[]

static byte[] toBytes(Object object);

}

class JSONObject {

Object get(String key);

int getIntValue(String key);

Integer getInteger(String key);

long getLongValue(String key);

Long getLong(String key);

T getObject(String key, Class objectClass);

// 将JSONObject对象转换为Java对象

T toJavaObject(Class objectClass);

}

class JSONArray {

Object get(int index);

int getIntValue(int index);

Integer getInteger(int index);

long getLongValue(int index);

Long getLong(int index);

T getObject(int index, Class objectClass);

}

class JSONPath {

// 构造JSONPath

static JSONPath of(String path);

// 根据path直接解析输入，会部分解析优化，不会全部解析

Object extract(JSONReader jsonReader);

// 根据path对对象求值

Object eval(Object rootObject);

}

class JSONReader {

// 构造基于String输入的JSONReader

static JSONReader of(String str);

// 构造基于utf8编码byte数组输入的JSONReader

static JSONReader of(byte[] utf8Bytes);

// 构造基于char[]输入的JSONReader

static JSONReader of(char[] chars);

// 构造基于json格式byte数组输入的JSONReader

static JSONReader ofJSONB(byte[] jsonbBytes)

}

3. 读取JSON对象

String str = "{\"id\":123}";

JSONObject jsonObject = JSON.parseObject(str);

int id = jsonObject.getIntValue("id");

String str = "[\"id\", 123]";

JSONArray jsonArray = JSON.parseArray(str);

String name = jsonArray.getString(0);

int id = jsonArray.getIntValue(1);

4. 将JavaBean对象生成JSON

4.1 将JavaBean对象生成JSON格式的字符串

class Product {

public int id;

public String name;

}

Product product = new Product();

product.id = 1001;

product.name = "DataWorks";

JSON.toJSONString(product);

// 生成如下的结果

{

"id" : 1001,

"name" : "DataWorks"

}

JSON.toJSONString(product, JSONWriter.Feature.BeanToArray);

// 生成如下的结果

[1001, "DataWorks"]

4.2 将JavaBean对象生成UTF8编码的byte[]

Product product = ...;

byte[] utf8JSONBytes = JSON.toJSONBytes(product);

4.3 将JavaBean对象生成JSONB格式的byte[]

Product product = ...;

byte[] jsonbBytes = JSONB.toBytes(product);

byte[] jsonbBytes = JSONB.toBytes(product, JSONWriter.Feature.BeanToArray);

5. 读取JavaBean

5.1 将字符串读取成JavaBean

String str = "{\"id\":123}";

Product product = JSON.parseObject(str, Product.class);

5.2 将UTF8编码的byte[]读取成JavaBean

byte[] utf8Bytes = "{\"id\":123}".getBytes(StandardCharsets.UTF_8);

Product product = JSON.parseObject(utf8Bytes, Product.class);

5.3 将JSONB数据读取成JavaBean

byte[] jsonbBytes = ...

Product product = JSONB.parseObject(jsonbBytes, Product.class);

Product product = JSONB.parseObject(jsonbBytes, Product.class, JSONReader.Feature.SupportBeanArrayMapping);

6. 使用JSONPath

6.1 使用JSONPath部分读取数据

String str = ...;

JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.of(str);

Object result = path.extract(parser);

6.2 使用JSONPath读取部分utf8Bytes的数据

byte[] utf8Bytes = ...;

JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.of(utf8Bytes);

Object result = path.extract(parser);

6.3 使用JSONPath读取部分jsonbBytes的数据

byte[] jsonbBytes = ...;

JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.ofJSONB(jsonbBytes); // 注意，这是利用ofJSONB方法

Object result = path.extract(parser);

7. FASTJSON v2应用场景

7.1 服务端应用场景

高性能

定制化序列化/反序列化

支持模块化，按需装载

针对JDK 8/JDK 9不同的字符串实现优化

静态化加速

安全，不能有反序列化安全问题

同一套API支持JSON/JSONB两种协议

7.2 大数据应用场景

部分解析

JSONPath是一等公民

7.3 Android应用场景

首次执行性能要足够好

静态化加速

同一套API支持JSON/JSONB两种协议

8. FASTJSON v2相关设计

8.1 Reader类结构

8.2 Writer类结构

8.3 解析关键算法

了解更多详见Github地址:

https://github.com/alibaba/fastjson2