Skip to content

JSON 직렬화 개요 ​

Kotlin 직렬화(serialization)를 사용하면 Kotlin 객체를 JSON으로 쉽게 변환하거나 그 반대로 변환할 수 있습니다. Json 클래스는 이를 위한 핵심 도구이며, JSON이 생성되고 파싱되는 방식에 유연성을 제공합니다. 특정 JSON 동작을 처리하도록 Json 인스턴스를 구성하거나, 기본적인 작업을 위해 기본(default) 인스턴스를 사용할 수 있습니다.

Json 클래스를 사용하면 다음 작업을 수행할 수 있습니다.

시작하기 전에 직렬화 라이브러리에서 다음 선언들을 임포트합니다.

kotlin
import kotlinx.serialization.*
import kotlinx.serialization.json.*

다음은 기본 Json 인스턴스를 사용하여 Kotlin에서 JSON 직렬화가 어떻게 작동하는지 보여주는 간단한 예제입니다.

kotlin
// 직렬화 라이브러리의 선언들을 임포트합니다
import kotlinx.serialization.*
import kotlinx.serialization.json.*

@Serializable
data class User(val name: String, val age: Int)

fun main() {
    // 기본 Json 인스턴스를 사용합니다
    val json = Json

    // User 객체를 생성합니다
    val user = User("Alice", 30)

    // User 객체를 JSON 문자열로 변환합니다
    val jsonString = json.encodeToString(user)
    println(jsonString)
    // {"name":"Alice","age":30}

    // JSON 문자열을 다시 User 객체로 변환합니다
    val deserializedUser = json.decodeFromString<User>(jsonString)
    println(deserializedUser)
    // User(name=Alice, age=30)
}

기본 구성을 사용하는 것 외에도, 알 수 없는 키를 무시하는 등 특정 사용 사례에 맞게 Json 인스턴스를 커스터마이징할 수 있습니다.

kotlin
// 직렬화 라이브러리의 선언들을 임포트합니다
import kotlinx.serialization.*
import kotlinx.serialization.json.*

@Serializable
data class Project(val name: String)

// 알 수 없는 키를 무시하도록 Json 인스턴스를 구성합니다
val customJson = Json {
    ignoreUnknownKeys = true
}

fun main() {
    val data = customJson.decodeFromString<Project>("""
        {"name":"kotlinx.serialization","language":"Kotlin"}
    """)
    println(data)
    // Project(name=kotlinx.serialization)
}

다음 단계 ​