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：
    1. <dependency>
    2.   <groupId>com.alibaba.fastjson2</groupId>
    3.   <artifactId>fastjson2</artifactId>
    4.   <version>2.x.x</version>
    5. </dependency>
    可以在 maven.org 查看最新可用的版本。

    2.2 fastjson v1的兼容包

    如果原来使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保证100%兼容，请仔细测试验证，发现问题请及时反馈。
    1. <dependency>
    2.   <groupId>com.alibaba</groupId>
    3.   <artifactId>fastjson</artifactId>
    4.   <version>2.x.x</version>
    5. </dependency>

    2.3 常用类和方法

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

class JSON { // 将字符串解析成JSONObject static JSONObject parseObject(String str);

  1. // 将字符串解析成JSONArray
  2. static JSONArray parseArray(String str);
  4. // 将字符串解析成Java对象
  5. static T parseObject(byte[] utf8Bytes, Class<T> objectClass);
  7. // 将Java对象输出成字符串
  8. static String toJSONString(Object object);
  10. // 将Java对象输出成UTF8编码的byte[]
  11. static byte[] toJSONBytes(Object object);

}

class JSONB { // 将jsonb格式的byte[]解析成Java对象 static T parseObject(byte[] jsonbBytes, Class objectClass);

  1. // 将Java对象输出成jsonb格式的byte[]
  2. 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);

  1. // 将JSONObject对象转换为Java对象
  2. 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 objectClass); }

class JSONPath { // 构造JSONPath static JSONPath of(String path);

  1. // 根据path直接解析输入，会部分解析优化，不会全部解析
  2. Object extract(JSONReader jsonReader);
  4. // 根据path对对象求值
  5. Object eval(Object rootObject);

}

class JSONReader { // 构造基于String输入的JSONReader static JSONReader of(String str);

  1. // 构造基于utf8编码byte数组输入的JSONReader
  2. static JSONReader of(byte[] utf8Bytes);
  4. // 构造基于char[]输入的JSONReader
  5. static JSONReader of(char[] chars);
  7. // 构造基于json格式byte数组输入的JSONReader
  8. static JSONReader ofJSONB(byte[] jsonbBytes)

}

  1. 读取JSON对象 ```

    3. 读取JSON对象

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

  1. <a name="W4Ell"></a>
  2. # 4. 将**JavaBean**对象生成**JSON**
  3. <a name="ZsmJE"></a>
  4. ## 4.1 将**JavaBean**对象生成**JSON**格式的字符串
  5. ```go
  6. class Product {
  7.     public int id;
  8.     public String name;
  9. }
  11. Product product = new Product();
  12. product.id = 1001;
  13. product.name = "DataWorks";
  15. JSON.toJSONString(product);
  17. // 生成如下的结果
  18. {
  19.     "id"   : 1001,
  20.     "name" : "DataWorks"
  21. }
  23. JSON.toJSONString(product, JSONWriter.Feature.BeanToArray);
  24. // 生成如下的结果
  25. [1001, "DataWorks"]

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

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

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

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

5. 读取JavaBean

5.1 将字符串读取成JavaBean

  1. String str = "{\"id\":123}";
  2. Product product = JSON.parseObject(str, Product.class);

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

  1. byte[] utf8Bytes = "{\"id\":123}".getBytes(StandardCharsets.UTF_8);
  2. Product product = JSON.parseObject(utf8Bytes, Product.class);

5.3 将JSONB数据读取成JavaBean

  1. byte[] jsonbBytes = ...
  2. Product product = JSONB.parseObject(jsonbBytes, Product.class);
  4. Product product = JSONB.parseObject(jsonbBytes, Product.class, JSONReader.Feature.SupportBeanArrayMapping);

6. 使用JSONPath

6.1 使用JSONPath部分读取数据

  1. String str = ...;
  3. JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
  5. JSONReader parser = JSONReader.of(str);
  7. Object result = path.extract(parser);

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

  1. byte[] utf8Bytes = ...;
  3. JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
  5. JSONReader parser = JSONReader.of(utf8Bytes);
  7. Object result = path.extract(parser);

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

  1. byte[] jsonbBytes = ...;
  3. JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能
  5. JSONReader parser = JSONReader.ofJSONB(jsonbBytes); // 注意，这是利用ofJSONB方法
  7. Object result = path.extract(parser);

7. FASTJSON v2应用场景

7.1 服务端应用场景

  1. 高性能
  2. 定制化序列化/反序列化
  3. 支持模块化，按需装载
  4. 针对JDK 8/JDK 9不同的字符串实现优化
  5. 静态化加速
  6. 安全，不能有反序列化安全问题

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

    7.2 大数据应用场景

  8. 部分解析

  9. JSONPath是一等公民

    7.3 Android应用场景

  10. 首次执行性能要足够好

  11. 静态化加速
  12. 同一套API支持JSON/JSONB两种协议

    8. FASTJSON v2相关设计

    8.1 Reader类结构

    image.png

    8.2 Writer类结构

    image.png

    8.3 解析关键算法

    image.png
    image.png
    了解更多详见Github地址: https://github.com/alibaba/fastjson2