JSON → Kotlin 데이터 클래스
JSON에서 kotlinx.serialization용 Kotlin data class를 생성. import 포함, 값에 따라 Int / Long / Double, 타입을 알 수 없는 값은 JsonElement, 중첩 객체 지원. 브라우저에서 실행.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
타입 매핑
- 문자열 →
String, 불리언 →Boolean - −2,147,483,648~2,147,483,647 정수 →
Int, 더 크면 →Long,Long범위 밖 →Double - 소수점이나 지수가 있는 숫자(
9.5,19.0,1e3) →Double - 배열 →
List<T>.Int·Long·Double이 섞이면 가장 넓은 타입, 그 밖의 혼합과 빈 배열은List<JsonElement> null→ nullable 타입, 항상null인 필드 →JsonElement?- 중첩 객체 → 별도
data class, 빈 객체{}→class Name(data class는 속성이 하나 이상 필요)
예시: snake_case API 응답
snake_case 키, null 필드, Int.MAX_VALUE를 넘는 카운터, 4.0으로 쓴 평점이 있는 입력:
{"user_id": 1024, "display_name": "Alice", "is_active": true, "last_login": null, "follower_count": 3000000000, "rating": 4.0, "tags": ["admin", "editor"], "address": {"city": "Tokyo", "zip_code": "100-0001"}}
출력:
import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable
import kotlinx.serialization.json.JsonElement
@Serializable
data class RootObject(
@SerialName("user_id")
val userId: Int = 0,
@SerialName("display_name")
val displayName: String = "",
@SerialName("is_active")
val isActive: Boolean = false,
@SerialName("last_login")
val lastLogin: JsonElement? = null,
@SerialName("follower_count")
val followerCount: Long = 0L,
val rating: Double = 0.0,
val tags: List<String> = emptyList(),
val address: Address = Address()
)
@Serializable
data class Address(
val city: String = "",
@SerialName("zip_code")
val zipCode: String = ""
)
camelCase 이름이 JSON 키와 다른 필드는 @SerialName으로 원래 키를 유지합니다. 키로 쓰인 Kotlin 키워드(class, in, fun)는 백틱으로 감쌉니다. 글자나 숫자가 없는 키(빈 키 "", "-" 등)는 속성 field(다음은 field2)가 되고 원래 키는 @SerialName에 남습니다. Kotlin 2.4.20은 _라는 이름의 속성을 받아들이지 않습니다. last_login은 샘플에서 null뿐이라 JsonElement?가 됩니다. 타임스탬프임을 알면 String?으로 바꾸세요.
예시: 객체 배열
루트가 배열이면 모든 객체를 하나의 클래스로 합칩니다. price가 2와 1.5이므로 Double이 됩니다. 일부 요소에만 있는 키는 nullable이며 기본값은 null입니다.
[{"id": 1, "name": "Pen", "price": 2}, {"id": 2, "name": "Ink", "price": 1.5, "discount": 0.1}]
import kotlinx.serialization.Serializable
@Serializable
data class RootObject(
val id: Int = 0,
val name: String = "",
val price: Double = 0.0,
val discount: Double? = null
)
상태 표시줄에 List<RootObject>로 디코딩하라는 안내가 나옵니다.
예시: 같은 이름의 키, 다른 객체
필드가 다른 meta 객체가 두 개 있으면 클래스도 두 개가 생성되고, 두 번째에는 부모 이름이 앞에 붙습니다.
{"order": {"id": 7, "meta": {"source": "web"}}, "payment": {"meta": {"method": "card", "last4": "4242"}}}
import kotlinx.serialization.Serializable
@Serializable
data class RootObject(
val order: Order = Order(),
val payment: Payment = Payment()
)
@Serializable
data class Order(
val id: Int = 0,
val meta: Meta = Meta()
)
@Serializable
data class Meta(
val source: String = ""
)
@Serializable
data class Payment(
val meta: PaymentMeta = PaymentMeta()
)
@Serializable
data class PaymentMeta(
val method: String = "",
val last4: String = ""
)
카카오 로그인 응답으로 확인하기
카카오 로그인 REST API 문서의 토큰 받기 응답 예제를 그대로 붙여 넣으면 다음 클래스가 나옵니다. ${ACCESS_TOKEN} 같은 값은 문서의 자리 표시자입니다.
{"token_type": "bearer", "access_token": "${ACCESS_TOKEN}", "expires_in": 43199, "refresh_token": "${REFRESH_TOKEN}", "refresh_token_expires_in": 5184000, "scope": "account_email profile"}
import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable
@Serializable
data class RootObject(
@SerialName("token_type")
val tokenType: String = "",
@SerialName("access_token")
val accessToken: String = "",
@SerialName("expires_in")
val expiresIn: Int = 0,
@SerialName("refresh_token")
val refreshToken: String = "",
@SerialName("refresh_token_expires_in")
val refreshTokenExpiresIn: Int = 0,
val scope: String = ""
)
같은 문서에는 OpenID Connect를 활성화한 앱의 응답 예제도 있는데, 여기에는 id_token이 더 들어 있습니다. 위 클래스로 이 응답을 디코딩하면 기본 Json이 모르는 키를 오류로 처리해 JsonDecodingException이 납니다. 두 응답 예제를 배열로 묶어 생성하면 id_token이 한쪽에만 있으므로 nullable이 됩니다.
[{"token_type": "bearer", "access_token": "${ACCESS_TOKEN}", "expires_in": 43199, "refresh_token": "${REFRESH_TOKEN}", "refresh_token_expires_in": 5184000, "scope": "account_email profile"}, {"token_type": "bearer", "access_token": "${ACCESS_TOKEN}", "id_token": "${ID_TOKEN}", "expires_in": 7199, "refresh_token": "${REFRESH_TOKEN}", "refresh_token_expires_in": 86399, "scope": "profile_image openid profile_nickname"}]
import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable
@Serializable
data class RootObject(
@SerialName("token_type")
val tokenType: String = "",
@SerialName("access_token")
val accessToken: String = "",
@SerialName("expires_in")
val expiresIn: Int = 0,
@SerialName("refresh_token")
val refreshToken: String = "",
@SerialName("refresh_token_expires_in")
val refreshTokenExpiresIn: Int = 0,
val scope: String = "",
@SerialName("id_token")
val idToken: String? = null
)
상태 표시는 루트가 배열이라며 List<RootObject>로 디코딩하라고 안내하지만, 토큰 응답은 한 번에 객체 하나이므로 Json.decodeFromString<RootObject>(body)로 읽습니다. 두 응답 예제 모두 이 클래스로 디코딩되는 것을 확인했습니다.
사용자 정보 가져오기 응답에서는 회원번호 id의 타입이 문서에 Long으로 적혀 있습니다. 문서의 필드 이름으로 만든 아래 샘플처럼 값이 작으면 도구는 Int를 고릅니다.
{"id": 123456789, "connected_at": "2026-10-08T01:23:45Z", "kakao_account": {"profile_nickname_needs_agreement": false, "profile": {"nickname": "홍길동", "is_default_nickname": false}}}
import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable
@Serializable
data class RootObject(
val id: Int = 0,
@SerialName("connected_at")
val connectedAt: String = "",
@SerialName("kakao_account")
val kakaoAccount: KakaoAccount = KakaoAccount()
)
@Serializable
data class KakaoAccount(
@SerialName("profile_nickname_needs_agreement")
val profileNicknameNeedsAgreement: Boolean = false,
val profile: Profile = Profile()
)
@Serializable
data class Profile(
val nickname: String = "",
@SerialName("is_default_nickname")
val isDefaultNickname: Boolean = false
)
id가 3000000000인 응답은 이 클래스로 디코딩하면 JsonDecodingException이 납니다. 문서대로 val id: Long = 0L로 고쳐 두세요. 중첩된 kakao_account와 profile은 각각 KakaoAccount, Profile 클래스가 됩니다. 값은 이 페이지용 예시입니다.
디코딩
빌드 설정에 직렬화 플러그인과 JSON 라이브러리를 추가하고(Kotlin 직렬화 가이드 참고) 다음처럼 디코딩합니다.
import kotlinx.serialization.json.Json
val user = Json.decodeFromString<RootObject>(body)
val items = Json.decodeFromString<List<RootObject>>(arrayBody)
// 샘플에 없던 키 허용
val lenient = Json { ignoreUnknownKeys = true }
기본 Json은 클래스에 없는 키를 오류로 처리합니다. 이 페이지의 예시는 모두 Kotlin 2.4.20과 kotlinx.serialization 1.11.0으로 컴파일하고 기본 설정으로 디코딩되는 것을 확인했습니다.
제한 사항
- 타입은 샘플 하나로만 정합니다. 샘플의 ID가 작으면
Int가 되므로, 실제 ID가 2,147,483,647을 넘는다면Long으로 바꾸세요. - 브라우저는 JSON 숫자를 64비트 부동소수점으로 읽기 때문에 9,007,199,254,740,991보다 큰 정수는 타입을 정하기 전에 자릿수를 잃습니다. 타입은
Long이지만 범위는 직접 확인하세요. 19.0을 소수로 판단하는 것은JSON.parse에 원본 텍스트를 넘겨주는 브라우저(Chrome 114+, Firefox 135+, Safari 18.4+)뿐입니다. 오래된 브라우저에서는Int가 됩니다.JsonElement필드는Json포맷에서만 동작하며 CBOR, ProtoBuf에서는 쓸 수 없습니다.- 날짜는
String으로 남습니다. JSON에는 날짜 타입이 없으므로 디코딩 후 파싱하거나 커스텀 시리얼라이저를 추가하세요. - 모든 속성에 기본값이 있어 키가 빠져도 조용히 기본값이 됩니다. 꼭 있어야 하는 키는 기본값을 지우세요.
FAQ
무엇을 생성하나요?
@Serializable(kotlinx.serialization)이 붙은 Kotlin data class와 필요한 import를 생성합니다. 중첩 객체마다 별도의 클래스가 만들어집니다. kotlinx.serialization 컴파일러 플러그인을 켜면 그대로 컴파일되고, 기본 Json 설정으로 샘플을 디코딩할 수 있습니다.
nullable 필드는 어떻게 처리되나요?
값이 null인 필드는 nullable 타입(예: String?)이 됩니다. 배열의 일부 요소에만 있는 키도 nullable이며 기본값은 null입니다. 샘플에서 항상 null인 필드는 실제 타입을 알 수 없으므로 JsonElement?가 됩니다.
타입별 기본값은?
String은 "", Int는 0, Long은 0L, Double은 0.0, Boolean은 false, List는 emptyList(), JsonElement는 JsonNull, nullable 타입은 null, 중첩 클래스는 인수 없는 생성자입니다. 기본값이 있어 키가 빠져도 디코딩됩니다.
Any 대신 JsonElement를 쓰는 이유는?
kotlinx.serialization에는 Any용 시리얼라이저가 없어서 Any 필드가 있는 @Serializable 클래스는 컴파일되지 않습니다. JsonElement는 형태를 알 수 없는 JSON을 위해 라이브러리가 제공하는 타입으로, 항상 null인 필드, 빈 배열, 샘플마다 타입이 다른 값에 씁니다.
데이터가 서버로 전송되나요?
아니요. JSON은 지금 보고 있는 브라우저 탭 안에서 변환되며, 서버로 전송되거나 브라우저 저장소에 저장되지 않습니다. 페이지 통계는 입력을 고친 뒤 포커스를 옮길 때, Kotlin 생성을 누를 때(Ctrl/⌘+Enter 포함), 예시를 누를 때 사용 이벤트(도구 이름과 동작 generate)만 기록하며, JSON 내용은 담지 않습니다.