本文摘抄自 《FastJson2项目文档》

1、使用准备
1.1 添加依赖
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.51</version>
</dependency>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

1.2 FastJson v1 to FastJson v2

如果原来使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保证100%兼容。

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>2.0.51</version>
</dependency>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
2、简单使用

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

  • parse
  • JSON.parse
  • JSON.parseObject
  • JSON.parseArray
  • to
  • JSON.to
  • JSON.toJSON
  • JSON.toJSONString
  • JSON.toJSONBytes
2.1 将JSON解析为JSONObject
String text = "...";
JSONObject data = JSON.parseObject(text);

byte[] bytes = ...;
JSONObject data = JSON.parseObject(bytes);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
2.2 将JSON解析为JSONArray
String text = "...";
JSONArray data = JSON.parseArray(text);
  • 1.
  • 2.
2.3 将JSON解析为Java对象
String text = "...";
User data = JSON.parseObject(text, User.class);
  • 1.
  • 2.
2.4 将Java对象序列化为JSON
Object data = "...";
String text = JSON.toJSONString(data);
byte[] text = JSON.toJSONBytes(data);
  • 1.
  • 2.
  • 3.
2.5 使用JSONObject、JSONArray
2.5.1 获取简单属性
String text = "{\"id\": 2,\"name\": \"fastjson2\"}";
JSONObject obj = JSON.parseObject(text);

int id = obj.getIntValue("id");
String name = obj.getString("name");
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
String text = "[2, \"fastjson2\"]";
JSONArray array = JSON.parseArray(text);

int id = array.getIntValue(0);
String name = array.getString(1);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
2.5.2 读取JavaBean
JSONArray array = ...
JSONObject obj = ...

User user = array.getObject(0, User.class);
User user = obj.getObject("key", User.class);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
2.5.3 转为JavaBean
JSONArray array = ...
JSONObject obj = ...

User user = obj.toJavaObject(User.class);
List<User> users = array.toJavaList(User.class);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
2.6 将JavaBean对象序列化为JSON
class User {
    public int id;
    public String name;
}

User user = new User();
user.id = 2;
user.name = "FastJson2";

String text = JSON.toJSONString(user);
byte[] bytes = JSON.toJSONBytes(user);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
3、进阶使用
3.1 使用JSONB
3.1.1 将JavaBean对象序列化JSONB
User user = ...;
byte[] bytes = JSONB.toBytes(user);
byte[] bytes = JSONB.toBytes(user, JSONWriter.Feature.BeanToArray);
  • 1.
  • 2.
  • 3.
3.1.2 将JSONB数据解析为JavaBean
byte[] bytes = ...
User user = JSONB.parseObject(bytes, User.class);
User user = JSONB.parseObject(bytes, User.class, JSONReader.Feature.SupportBeanArrayMapping);
  • 1.
  • 2.
  • 3.
3.2 使用JSONPath
3.2.1 使用JSONPath读取部分数据
String text = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.of(text);
Object result = path.extract(parser);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
3.2.2 使用JSONPath读取部分byte[]的数据
byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.of(bytes);
Object result = path.extract(parser);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
3.2.3 使用JSONPath读取部分byte[]的数据
byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader.ofJSONB(bytes); // 注意这里使用ofJSONB方法
Object result = path.extract(parser);
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
4、SpringFramework集成FastJson2
4.1 添加依赖
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2-extension</artifactId>
    <version>2.0.x</version>
</dependency>
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.

详细见 《在Spring中集成FastJson2》