Kotlin Academy · 강의

JSON 인코딩과 디코딩

JSON으로 변환하거나 JSON에서 변환합니다

JSON 인코딩과 디코딩은(는) CoddyKit의 무료 Kotlin Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Kotlin Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

Json 객체

Json 객체는 인코딩과 디코딩의 핵심입니다. 기본 인스턴스를 바로 사용할 수도 있고, 설정된 인스턴스를 만들 수도 있습니다.

import kotlinx.serialization.json.Json

val json = Json

문자열로 인코딩하기

encodeToString을 사용하여 객체를 JSON 문자열로 변환합니다.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val book = Book("Kotlin in Action", 360)
    val text = Json.encodeToString(book)
    println(text)
}

문자열에서 디코딩하기

decodeFromString을 사용하여 JSON을 다시 객체로 구문 분석합니다. 대상 형식은 추론되거나 명시적으로 지정됩니다.

import kotlinx.serialization.Serializable
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class Book(val title: String, val pages: Int)

fun main() {
    val text = "{\"title\":\"Atomic Kotlin\",\"pages\":500}"
    val book = Json.decodeFromString<Book>(text)
    println(book.title)
}

목록 인코딩하기

컬렉션은 자동으로 인코딩됩니다. 직렬화 가능한 객체의 목록은 JSON 배열이 됩니다.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Tag(val name: String)

fun main() {
    val tags = listOf(Tag("kotlin"), Tag("json"))
    println(Json.encodeToString(tags))
}

보기 좋게 출력하기

Json { } 빌더를 설정하여 들여쓰기된 출력을 활성화할 수 있으며, 로그 기록과 디버깅에 유용합니다.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.json.Json

@Serializable
data class Point(val x: Int, val y: Int)

val pretty = Json { prettyPrint = true }

fun main() {
    println(pretty.encodeToString(Point(1, 2)))
}

알 수 없는 키 무시하기

기본적으로 JSON에 클래스에 없는 키가 포함되면 디코딩이 실패합니다. ignoreUnknownKeys = true로 설정하면 해당 키를 건너뛸 수 있어 API가 발전할 때 유용합니다.

import kotlinx.serialization.json.Json

val lenient = Json { ignoreUnknownKeys = true }

기본값 인코딩하기

기본적으로 기본값과 같은 속성은 기록되지 않습니다. encodeDefaults = true를 활성화하면 해당 속성을 항상 포함합니다.

import kotlinx.serialization.json.Json

val withDefaults = Json { encodeDefaults = true }

JsonElement 사용하기

동적 JSON의 경우 형식이 지정된 클래스 대신 JsonElement 트리로 구문 분석할 수 있습니다.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.JsonElement

fun main() {
    val element: JsonElement = Json.parseToJsonElement("{\"a\":1}")
    println(element)
}

JsonObject 필드 읽기

JsonElement를 JsonObject로 변환하고 키로 필드에 접근한 다음 기본 값을 변환합니다.

import kotlinx.serialization.json.Json
import kotlinx.serialization.json.jsonObject
import kotlinx.serialization.json.jsonPrimitive
import kotlinx.serialization.json.int

fun main() {
    val obj = Json.parseToJsonElement("{\"a\":1}").jsonObject
    val a = obj["a"]!!.jsonPrimitive.int
    println(a)
}

왕복 변환

인코딩한 다음 디코딩하면 동일한 객체가 반환되어야 합니다(왕복 변환). 이는 모델이 올바른지 간단히 확인하는 좋은 방법입니다.

import kotlinx.serialization.Serializable
import kotlinx.serialization.encodeToString
import kotlinx.serialization.decodeFromString
import kotlinx.serialization.json.Json

@Serializable
data class P(val x: Int)

fun main() {
    val original = P(42)
    val back = Json.decodeFromString<P>(Json.encodeToString(original))
    println(original == back)
}

일반적인 디코딩 오류

다음 런타임 예외에 주의하세요:

SerializationException: Unexpected JSON token — 형식이 잘못된 JSON
필수 필드 누락 — JSON에 기본값이 없는 속성이 없음
알 수 없는 키 — ignoreUnknownKeys로 엄격한 검사를 해제

빠른 확인

API에서 새 JSON 필드를 자주 추가합니다. 디코딩이 중단되지 않도록 하는 설정은 무엇인가요?

복습

이제 객체와 JSON 사이를 변환할 수 있습니다:

encodeToString / decodeFromString
Json { }로 설정: prettyPrint, ignoreUnknownKeys, encodeDefaults
JsonElement를 통해 동적 JSON 구문 분석

다음에는 지원되지 않는 형식을 위한 사용자 지정 직렬화기를 학습합니다.

자주 묻는 질문

“JSON 인코딩과 디코딩” 강의는 무료인가요?

네 — “JSON 인코딩과 디코딩” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Kotlin Academy 강의 전체를 잠금 해제할 수 있습니다. Kotlin Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“JSON 인코딩과 디코딩”에서 뭘 배우나요?

JSON으로 변환하거나 JSON에서 변환합니다 브라우저에서 직접 실행하는 실습 코드로 Kotlin Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Kotlin Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Kotlin Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“JSON 인코딩과 디코딩” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Kotlin Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Kotlin Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Kotlin Academy(으)로 돌아가기