English Documentation |

Issues

FASTJSON v2

FASTJSON 2Java JSON

• FASTJSON 2``FASTJSONFASTJSON 1autoType
• JSONjackson/gson/org.json: https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
• JDKJDK 11/JDK 17``compact stringRecordGraalVM Native-Image
• JSONPathSQL:2016JSONPath
• Android 8+API
• Kotlin https://alibaba.github.io/fastjson2/kotlin_cn
• JSON Schema https://alibaba.github.io/fastjson2/json_schema_cn
• JSONB https://alibaba.github.io/fastjson2/jsonb_format_cn

1.

1.1

fastjson v2``groupId``1.x``com.alibaba.fastjson2

Maven:

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

Gradle:

dependencies {
    implementation 'com.alibaba.fastjson2:fastjson2:2.0.40'
}

maven.org

1.2

Fastjson v1

fastjson 1.2.x100%

Maven:

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

Gradle:

dependencies {
    implementation 'com.alibaba:fastjson:2.0.40'
}

Fastjson Kotlin

Kotlin``fastjson-kotlin``kotlin

• Maven:

<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2-kotlin</artifactId>
    <version>2.0.40</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.40")
}

dependencies {
    implementation("org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version")
    implementation("org.jetbrains.kotlin:kotlin-reflect:$kotlin_version")
}

Fastjson Extension

SpringFramework``fastjson-extension SpringFramework Support

Maven:

<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2-extension-spring5</artifactId>
    <version>2.0.40</version>
</dependency>

<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2-extension-spring6</artifactId>
    <version>2.0.40</version>
</dependency>

Gradle:

dependencies {
    implementation 'com.alibaba.fastjson2:fastjson2-extension-spring5:2.0.40'
}

dependencies {
    implementation 'com.alibaba.fastjson2:fastjson2-extension-spring6:2.0.40'
}

2.

fastjson v2``package``1.x``com.alibaba.fastjson2``fastjson1

2.1 JSON``JSONObject

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() // JSONObject

2.2 JSON``JSONArray

Java:

String text = "...";
JSONArray data = JSON.parseArray(text);

Kotlin:

import com.alibaba.fastjson2.*

val text = ... // String
val data = text.parseArray() // JSONArray

2.3 JSON``Java

Java:

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>() // User

2.4 Java``JSON

Java:

Object data = "...";
String text = JSON.toJSONString(data);
byte[] text = JSON.toJSONBytes(data);

Kotlin:

import com.alibaba.fastjson2.*

val data = ... // Any
val text = text.toJSONString() // String
val bytes = text.toJSONByteArray() // ByteArray

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

String text = "[2, \"fastjson2\"]";
JSONArray array = JSON.parseArray(text);

int id = array.getIntValue(0);
String name = array.getString(1);

2.5.2 JavaBean

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")

2.5.3 JavaBean

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>

2.6 JavaBean``JSON

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"
}

3.

3.1 JSONB

3.1.1 JavaBean``JSONB

User user = ...;
byte[] bytes = JSONB.toBytes(user);
byte[] bytes = JSONB.toBytes(user, JSONWriter.Feature.BeanToArray);

3.1.2 JSONB``JavaBean

byte[] bytes = ...
User user = JSONB.parseObject(bytes, User.class);
User user = JSONB.parseObject(bytes, User.class, JSONReader.Feature.SupportBeanArrayMapping);

3.2 JSONPath

3.2.1 JSONPath

String text = ...;
JSONPath path = JSONPath.of("$.id"); // 

JSONReader parser = JSONReader.of(text);
Object result = path.extract(parser);

3.2.2 JSONPath``byte[]

byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 

JSONReader parser = JSONReader.of(bytes);
Object result = path.extract(parser);

3.2.3 JSONPath``byte[]

byte[] bytes = ...;
JSONPath path = JSONPath.of("$.id"); // 

JSONReader parser = JSONReader.ofJSONB(bytes); // ofJSONB
Object result = path.extract(parser);

Star History