Unduh fastjson2 - pengunduhan kode sumber fastjson2

Dokumentasi Bahasa Inggris |. Dokumentasi Bahasa Mandarin

Masalah proyek ini akan disimpan ke Komunitas Pengembang Alibaba Cloud secara bersamaan.

FASTJSON v2

FASTJSON 2 adalah perpustakaan Java JSON yang sangat berkinerja dan mudah digunakan.

FASTJSON 2 adalah peningkatan penting dari proyek FASTJSON . Dibandingkan dengan FASTJSON 1, kinerjanya telah meningkat pesat dan masalah keamanan fungsi autoType karena kompatibilitas dan daftar putih telah diselesaikan.
Performa ekstrem, performa jauh melebihi pustaka JSON populer lainnya, termasuk jackson/gson/org.json, data performa: https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
Mendukung fitur JDK baru, termasuk JDK 11 / JDK 17 , dioptimalkan untuk compact string , mendukung Record, mendukung GraalVM Native-Image
Dukungan JSONPath lengkap, mendukung sintaksis SQL:2016 JSONPath
Mendukung Android 8+ , sekumpulan API untuk klien dan server
Mendukung Kotlin https://alibaba.github.io/fastjson2/kotlin_cn
Mendukung JSON Schema https://alibaba.github.io/fastjson2/json_schema_cn
Dukungan yang baru ditambahkan untuk format biner JSONB https://alibaba.github.io/fastjson2/jsonb_format_cn

logo fastjson

1. Persiapan penggunaan

1.1 Tambahkan dependensi

Di fastjson v2 , groupId berbeda dengan 1.x , yaitu com.alibaba.fastjson2 :

Maven :

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

Gradle :

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

Anda dapat melihat versi terbaru yang tersedia di maven.org.

1.2 Modul lainnya

Modul yang kompatibel dengan `Fastjson v1`

Jika Anda awalnya menggunakan versi fastjson 1.2.x , Anda dapat menggunakan paket kompatibilitas. Paket kompatibilitas tidak dapat menjamin kompatibilitas 100%. Harap uji dan verifikasi dengan cermat dan berikan umpan balik tepat waktu jika Anda menemukan masalah.

Maven :

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

Gradle :

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

Modul integrasi `Fastjson Kotlin`

Jika proyek menggunakan Kotlin , Anda dapat menggunakan modul fastjson-kotlin dan mengadopsi fitur kotlin .

Maven :

< dependency >
    < groupId >com.alibaba.fastjson2</ groupId >
    < artifactId >fastjson2-kotlin</ artifactId >
    < version >2.0.53</ version >
</ dependency >

Tambahkan pustaka standar (kotlin-stdlib) dan pustaka refleksi (kotlin-reflect) yang sesuai. Jika Anda menggunakan kelas data (kelas data) dan meneruskan parameter melalui konstruktor, tambahkan pustaka refleksi.

< 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.53 " )
}

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

Modul ekstensi `Fastjson Extension`

Jika proyek menggunakan kerangka kerja seperti SpringFramework , Anda dapat menggunakan modul fastjson-extension . Untuk penggunaan, lihat Dukungan SpringFramework.

Maven :

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

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

Gradle :

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

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

2. Mudah digunakan

Di fastjson v2 , package berbeda dengan 1.x , yaitu com.alibaba.fastjson2 . Jika Anda pernah menggunakan fastjson1 sebelumnya, biasanya Anda cukup mengubah nama paket.

2.1 Parsing `JSON` menjadi `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 Parsing `JSON` ke dalam `JSONArray`

Java :

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

Kotlin :

 import com.alibaba.fastjson2.*

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

2.3 Parsing `JSON` ke dalam objek `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 Membuat serial objek `Java` ke `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 Menggunakan `JSONObject` dan `JSONArray`

2.5.1 Mendapatkan atribut sederhana

 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 Membaca `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 Konversi ke `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 Membuat serial objek `JavaBean` ke `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

Hasil serialisasi:

{
    "id"   : 2 ,
    "name" : " FastJson2 "
}

3. Penggunaan tingkat lanjut

3.1 Menggunakan `JSONB`

3.1.1 Membuat serial objek `JavaBean` `JSONB`

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

3.1.2 Parsing data `JSONB` ke dalam `JavaBean`

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

3.2 Menggunakan `JSONPath`

3.2.1 Gunakan `JSONPath` untuk membaca beberapa data

 String text = ...;
JSONPath path = JSONPath . of ( "$.id" ); // 缓存起来重复使用能提升性能

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

3.2.2 Gunakan `JSONPath` untuk membaca sebagian data `byte[]` .

 byte [] bytes = ...;
JSONPath path = JSONPath . of ( "$.id" ); // 缓存起来重复使用能提升性能

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

3.2.3 Gunakan `JSONPath` untuk membaca sebagian data `byte[]`

 byte [] bytes = ...;
JSONPath path = JSONPath . of ( "$.id" ); // 缓存起来重复使用能提升性能

JSONReader parser = JSONReader . ofJSONB ( bytes ); // 注意这里使用ofJSONB方法
Object result = path . extract ( parser );