📖 English Documentation | 📖 中文文档
本项目的Issues会被同步沉淀至阿里云开发者社区
FASTJSON 2是一个性能极致并且简单易用的Java JSON库。
FASTJSON 2是FASTJSON项目的重要升级，和FASTJSON 1相比，性能有非常大的提升，解决了autoType功能因为兼容和白名单的安全性问题。- 性能极致，性能远超过其他流行JSON库，包括jackson/gson/org.json，性能数据: https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
- 支持JDK新特性，包括
JDK 11/JDK 17，针对compact string优化，支持Record，支持GraalVM Native-Image - 完善的
JSONPath支持，支持SQL:2016的JSONPath语法 - 支持
Android 8+，客户端和服务器一套API - 支持
Kotlinhttps://alibaba.github.io/fastjson2/kotlin_cn - 支持
JSON Schemahttps://alibaba.github.io/fastjson2/json_schema_cn - 新增加支持二进制格式JSONB https://alibaba.github.io/fastjson2/jsonb_format_cn
在fastjson v2中，groupId和1.x不一样，是com.alibaba.fastjson2：
Maven:
<dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2</artifactId> <version>2.0.57</version> </dependency>Gradle:
dependencies { implementation 'com.alibaba.fastjson2:fastjson2:2.0.57' }可以在 maven.org 查看最新可用的版本。
如果原来使用fastjson 1.2.x版本，可以使用兼容包，兼容包不能保证100%兼容，请仔细测试验证，发现问题请及时反馈。
Maven:
<dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>2.0.57</version> </dependency>Gradle:
dependencies { implementation 'com.alibaba:fastjson:2.0.57' }如果项目使用Kotlin，可以使用fastjson-kotlin模块，使用方式上采用kotlin的特性。
Maven:
<dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-kotlin</artifactId> <version>2.0.57</version> </dependency>酌情添加标准库(kotlin-stdlib)、反射库(kotlin-reflect)， 其中若使用数据类(data class)、通过构造函数传入参数则添加反射库。
<dependency> <groupId>org.jetbrains.kotlin</groupId> <artifactId>kotlin-stdlib</artifactId> <version>${kotlin-version}</version> </dependency> <dependency> <groupId>org.jetbrains.kotlin</groupId> <artifactId>kotlin-reflect</artifactId> <version>${kotlin-version}</version> </dependency>Kotlin Gradle:
dependencies { implementation("com.alibaba.fastjson2:fastjson2-kotlin:2.0.57") }dependencies { implementation("org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version") implementation("org.jetbrains.kotlin:kotlin-reflect:$kotlin_version") }如果项目使用SpringFramework等框架，可以使用fastjson-extension模块，使用方式参考 SpringFramework Support。
Maven:
<dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-extension-spring5</artifactId> <version>2.0.57</version> </dependency><dependency> <groupId>com.alibaba.fastjson2</groupId> <artifactId>fastjson2-extension-spring6</artifactId> <version>2.0.57</version> </dependency>Gradle:
dependencies { implementation 'com.alibaba.fastjson2:fastjson2-extension-spring5:2.0.57' }dependencies { implementation 'com.alibaba.fastjson2:fastjson2-extension-spring6:2.0.57' }在fastjson v2中，package和1.x不一样，是com.alibaba.fastjson2。如果你之前用的是fastjson1，大多数情况直接更包名就即可。
Java:
String text = "..."; JSONObject data = JSON.parseObject(text); byte[] bytes = ...; JSONObject data = JSON.parseObject(bytes);Kotlin:
import com.alibaba.fastjson2.* val text = ... // String val data = text.parseObject() val bytes = ... // ByteArray val data = bytes.parseObject() // JSONObjectJava:
String text = "..."; JSONArray data = JSON.parseArray(text);Kotlin:
import com.alibaba.fastjson2.* val text = ... // String val data = text.parseArray() // JSONArrayJava:
String text = "..."; User data = JSON.parseObject(text, User.class);Kotlin:
import com.alibaba.fastjson2.* val text = ... // String val data = text.to<User>() // User val data = text.parseObject<User>() // UserJava:
Object data = "..."; String text = JSON.toJSONString(data); byte[] text = JSON.toJSONBytes(data);Kotlin:
import com.alibaba.fastjson2.* val data = ... // Any val text = data.toJSONString() // String val bytes = data.toJSONByteArray() // ByteArrayString text = "{\"id\": 2,\"name\": \"fastjson2\"}"; JSONObject obj = JSON.parseObject(text); int id = obj.getIntValue("id"); String name = obj.getString("name");String text = "[2, \"fastjson2\"]"; JSONArray array = JSON.parseArray(text); int id = array.getIntValue(0); String name = array.getString(1);Java:
JSONArray array = ... JSONObject obj = ... User user = array.getObject(0, User.class); User user = obj.getObject("key", User.class);Kotlin:
val array = ... // JSONArray val obj = ... // JSONObject val user = array.to<User>(0) val user = obj.to<User>("key")Java:
JSONArray array = ... JSONObject obj = ... User user = obj.toJavaObject(User.class); List<User> users = array.toJavaList(User.class);Kotlin:
val array = ... // JSONArray val obj = ... // JSONObject val user = obj.to<User>() // User val users = array.toList<User>() // List<User>Java:
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);Kotlin:
class User( var id: Int, var name: String ) val user = User() user.id = 2 user.name = "FastJson2" val text = user.toJSONString() // String val bytes = user.toJSONByteArray() // ByteArray序列化结果:
{ "id" : 2, "name" : "FastJson2" }User user = ...; byte[] bytes = JSONB.toBytes(user); byte[] bytes = JSONB.toBytes(user, JSONWriter.Feature.BeanToArray);byte[] bytes = ... User user = JSONB.parseObject(bytes, User.class); User user = JSONB.parseObject(bytes, User.class, JSONReader.Feature.SupportBeanArrayMapping);String text = ...; JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能 JSONReader parser = JSONReader.of(text); Object result = path.extract(parser);byte[] bytes = ...; JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能 JSONReader parser = JSONReader.of(bytes); Object result = path.extract(parser);byte[] bytes = ...; JSONPath path = JSONPath.of("$.id"); // 缓存起来重复使用能提升性能 JSONReader parser = JSONReader.ofJSONB(bytes); // 注意这里使用ofJSONB方法 Object result = path.extract(parser);