FASTJSON 2.0 是 FASTJSON 專案的重要升級，目標是為下一個十年提供一個高效能的 JSON 庫，同一套 API 支援 JSON/JSONB 兩種協定，JSONPath 是一等公民，支援全量解析和部分解析，支援 Java 伺服器端、使用者端 Android、巨量資料場景。

1. 介紹

FASJTONS2 程式碼
JSONB 格式檔案
FASTJSON 2 效能有了很大提升，具體效能資料看這裡

2. 使用前準備

2.1 Maven依賴

在fastjson 2.0中，groupId和1.x不一樣，是com.alibaba.fastjson2

<dependency>
	<groupId>com.alibaba.fastjson2</groupId>
	<artifactId>fastjson2</artifactId>
	<version>2.0.1</version>
</dependency>

2.2

如果原來使用fastjson 1.2.x版本，可以使用相容包，相容包不能保證100%相容，請仔細測試驗證，發現問題請及時反饋。

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

2.2 常用類和方法

在fastjson 2.0中，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<T> objectClass);

    // 將Java物件輸出成字串
    static String toJSONString(Object object);
    
    // 將Java物件輸出成UT8編碼的byte[]
    static byte[] toJSONBytes(Object object);
}

class JSONB {
    // 將jsonb格式的byte[]解析成Java物件
    static T parseObject(byte[] jsonbBytes, Class<T> 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<T> objectClass);
    
    // 將JSONObject物件轉換為Java物件
    T toJavaObject(Class<T> 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<T> 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);
    
    // 構造基於ut8編碼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);
// 生成如下的結果
[123, "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);

詳情可檢視：

FASTJSON 2.0 和 2.0.1 釋出，FASTJSON 專案的重要升級