fastjson2 다운로드 - fastjson2 소스 코드 다운로드

영어 문서 중국어 문서 |

이 프로젝트의 이슈는 Alibaba Cloud 개발자 커뮤니티에 동시에 기탁됩니다.

FASTJSON v2

FASTJSON 2 는 성능이 매우 뛰어나고 사용하기 쉬운 Java JSON 라이브러리입니다.

FASTJSON 2 는 FASTJSON 프로젝트의 중요한 업그레이드로, FASTJSON 1과 비교하여 성능이 크게 향상되었으며 호환성 및 화이트리스트로 인한 autoType 기능의 보안 문제가 해결되었습니다.
최고의 성능, jackson/gson/org.json을 포함한 다른 인기 JSON 라이브러리를 훨씬 능가하는 성능, 성능 데이터: https://github.com/alibaba/fastjson2/wiki/fastjson_benchmark
compact string 에 최적화된 JDK 11 / JDK 17 포함한 새로운 JDK 기능 지원, 기록 지원, GraalVM Native-Image 지원
SQL:2016 JSONPath 구문을 지원하는 완전한 JSONPath 지원
클라이언트 및 서버용 API 세트인 Android 8+ 지원
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에 대한 지원이 새로 추가되었습니다.

fastjson 로고

1. 사용 준비

1.1 종속성 추가

fastjson v2 에서는 groupId 1.x 와 다르며 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 '
}

maven.org에서 사용 가능한 최신 버전을 볼 수 있습니다.

1.2 기타 모듈

`Fastjson v1` 호환 모듈

원래 fastjson 1.2.x 버전을 사용했다면 호환성 패키지를 사용할 수 있습니다. 호환성 패키지는 100% 호환성을 보장할 수 없습니다. 주의 깊게 테스트하고 확인한 후 문제가 발견되면 적시에 피드백을 제공하십시오.

Maven :

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

Gradle :

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

`Fastjson Kotlin` 통합 모듈

프로젝트에서 Kotlin 사용하는 경우 fastjson-kotlin 모듈을 사용하고 kotlin 기능을 채택할 수 있습니다.

Maven :

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

표준 라이브러리(kotlin-stdlib)와 리플렉션 라이브러리(kotlin-reflect)를 적절하게 추가합니다. 데이터 클래스(데이터 클래스)를 사용하고 생성자를 통해 매개변수를 전달하는 경우 리플렉션 라이브러리를 추가합니다.

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

`Fastjson Extension` 모듈

프로젝트가 SpringFramework 와 같은 프레임워크를 사용하는 경우 fastjson-extension 모듈을 사용할 수 있습니다. 사용법은 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. 사용하기 쉬움

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