1. FASTJSON 2.0介紹
FASTJSON 2.0是FASTJSON項(xiàng)目的重要升級(jí)，目標(biāo)是為下一個(gè)十年提供一個(gè)高性能的JSON庫(kù)，同一套API支持JSON/JSONB兩種協(xié)議，JSONPath是一等公民，支持全量解析和部分解析，支持Java服務(wù)端、客戶端Android、大數(shù)據(jù)場(chǎng)景。
- FASJTONS2代碼 https://github.com/alibaba/fastjson2/releases/tag/2.0.1
- JSONB格式文檔 https://github.com/alibaba/fastjson2/wiki/jsonb_format_cn
FASTJSON 2性能有了很大提升，具體性能數(shù)據(jù)看這里：
https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
2. 使用前準(zhǔn)備
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>
如果原來(lái)使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保證100%兼容，請(qǐng)仔細(xì)測(cè)試驗(yàn)證，發(fā)現(xiàn)問(wèn)題請(qǐng)及時(shí)反饋。
<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，大多數(shù)情況直接更包名就即可。
package com.alibaba.fastjson2;
class JSON {
// 將字符串解析成JSONObject
static JSONObject parseObject(String str);
// 將字符串解析成JSONArray
static JSONArray parseArray(String str);
// 將字符串解析成Java對(duì)象
static T parseObject(byte[] utf8Bytes, Class<T> objectClass);
// 將Java對(duì)象輸出成字符串
static String toJSONString(Object object);
// 將Java對(duì)象輸出成UT8編碼的byte[]
static byte[] toJSONBytes(Object object);
}
class JSONB {
// 將jsonb格式的byte[]解析成Java對(duì)象
static T parseObject(byte[] jsonbBytes, Class<T> objectClass);
// 將Java對(duì)象輸出成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對(duì)象轉(zhuǎn)換為Java對(duì)象
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 {
// 構(gòu)造JSONPath
static JSONPath of(String path);
// 根據(jù)path直接解析輸入，會(huì)部分解析優(yōu)化，不會(huì)全部解析
Object extract(JSONReader jsonReader);
// 根據(jù)path對(duì)對(duì)象求值
Object eval(Object rootObject);
}
class JSONReader {
// 構(gòu)造基于String輸入的JSONReader
static JSONReader of(String str);
// 構(gòu)造基于ut8編碼byte數(shù)組輸入的JSONReader
static JSONReader of(byte[] utf8Bytes);
// 構(gòu)造基于char[]輸入的JSONReader
static JSONReader of(char[] chars);
// 構(gòu)造基于json格式byte數(shù)組輸入的JSONReader
static JSONReader ofJSONB(byte[] jsonbBytes)
}
3. 讀取JSON對(duì)象
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對(duì)象生成JSON
4.1 將JavaBean對(duì)象生成JSON格式的字符串
class Product {
public int id;
public String name;
}
Product product = new Product();
product.id = 1001;
product.name = "DataWorks";
JSON.toJSONString(product);
// 生成如下的結(jié)果
{
"id" : 1001,
"name" : "DataWorks"
}
JSON.toJSONString(product, JSONWriter.Feature.BeanToArray);
// 生成如下的結(jié)果
[123, "DataWorks"]
4.2 將JavaBean對(duì)象生成UTF8編碼的byte[]
Product product = ...;
byte[] utf8JSONBytes = JSON.toJSONBytes(product);
4.3 將JavaBean對(duì)象生成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數(shù)據(jù)讀取成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部分讀取數(shù)據(jù)
String str = ...;
JSONPath path = JSONPath.of("$.id"); // 緩存起來(lái)重復(fù)使用能提升性能
JSONReader parser = JSONReader.of(str);
Object result = path.extract(parser);
6.2 使用JSONPath讀取部分utf8Bytes的數(shù)據(jù)
byte[] utf8Bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 緩存起來(lái)重復(fù)使用能提升性能
JSONReader parser = JSONReader.of(utf8Bytes);
Object result = path.extract(parser);
6.3 使用JSONPath讀取部分jsonbBytes的數(shù)據(jù)
byte[] jsonbBytes = ...;
JSONPath path = JSONPath.of("$.id"); // 緩存起來(lái)重復(fù)使用能提升性能
JSONReader parser = JSONReader.ofJSONB(jsonbBytes); // 注意，這是利用ofJSONB方法
Object result = path.extract(parser);
