fastjson2 - 🚄FASTJSON2は、FASTJSONプロジェクトの重要なアップグレードであり、次の10年間に高性能のJSONライブラリを提供することを目的としています。

(🚄 FASTJSON2是FASTJSON项目的重要升级,目标是为下一个十年提供一个高性能的JSON库)

Created at: 2022-04-17 12:27:24
Language: Java
License: Apache-2.0

Java CI Codecov Maven Central GitHubリリース Javaサポート ライセンス Gitpod Ready-to-Code 最後のスナップショット GitHubスター GitHubフォーク ユーザーリポジトリ GitHubコントリビューター

言語:中国語|英語

1. FASTJSON v2

FASTJSON v2
は、プロジェクトの重要なアップグレードであり
FASTJSON
、次の10年間に高性能
JSON
ライブラリを提供することを目的としています。同じセットを通して
API

  • JSON/JSONB
    両方の協定を支持し、
    JSONPath
    一級市民です。
  • 完全な解析と部分的な解析をサポートします。
  • Java
    サーバー、クライアント
    Android
    、およびビッグデータのシナリオをサポートします。

fastjson

関連文書:

2.使用前の準備

2.1
Maven
依存関係

fastjson v2
、同じでは
groupId
ありませんが、 :
1.x
com.alibaba.fastjson2

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

利用可能な最新バージョンは、 maven.orgで表示できます。

2.2
fastjson v1
互換性パック

元の

fastjson 1.2.x
バージョンを使用している場合は、互換性パッケージを使用できます。互換性パッケージは100%の互換性を保証するものではありません。慎重にテストおよび検証してください。問題が見つかった場合は、時間内にフィードバックしてください。

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

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

    // 构造基于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);