JSON 입력

Kotlin 출력

JSON을 Kotlin으로란?

Android 앱이나 Kotlin 백엔드 서비스를 만들면서 JSON API 응답을 받을 때, 역직렬화하기 전에 구조와 일치하는 Kotlin Data Class가 필요합니다. 특히 깊이 중첩된 객체를 수작업으로 작성하는 건 느리고 오류가 발생하기 쉽습니다. 이 도구는 JSON에서 Kotlin Data Class를 자동으로 생성합니다. 샘플 응답을 붙여넣으면 몇 초 안에 kotlinx.serialization이나 Gson에서 바로 사용할 수 있는 모델을 얻을 수 있습니다.

변환은 브라우저에서 수행됩니다. data class 이름과 패키지를 설정하세요. Data class와 Nullable 타입을 활성화하세요. 서버로 전송되지 않습니다.

이 도구 사용 방법

1

JSON 붙여넣기 또는 업로드

왼쪽 편집기에 JSON을 붙여넣거나 파일을 업로드합니다. 샘플 데이터를 보려면 샘플을 사용하세요. 루트 data class 이름과 패키지를 설정하세요. 선택적 필드에 대해 Data class 사용Nullable 타입을 활성화하세요.

2

생성된 타입 확인

오른쪽 패널에 Kotlin data class가 표시됩니다. 중첩 객체는 중첩 타입이 됩니다. 파싱을 위해 Gson().fromJson() 또는 Json.decodeFromString()을 사용하세요. 잘못된 JSON의 경우 먼저 JSON 포매터 또는 JSON 검증기를 사용하세요.

3

복사 또는 다운로드

복사 또는 다운로드를 사용하세요. JSON 서식 지정을 위해 먼저 JSON 포매터를 사용하세요. 검증을 위해 JSON 검증기를 사용하세요.

JSON을 Kotlin으로 변환 예시

다음은 JSON 객체에서 Kotlin data class를 생성하는 예시입니다.

예시: 구독자 레코드

JSON 입력:

입력

생성된 Kotlin 출력:

출력

JSON을 Kotlin으로 변환이 도움이 되는 경우

REST API를 사용하는 Android 또는 Kotlin 개발 시 여기에서 data class를 생성하세요. Gson 또는 kotlinx.serialization을 사용한 타입이 지정된 모델을 위해 샘플 응답을 붙여넣으세요. Android Room, Retrofit 또는 Ktor의 경우 Kotlin 모델이 필요합니다.

자주 묻는 질문

Kotlin Data Class는 JSON과 어떻게 작동하나요?

Kotlin Data Class는 자동 생성된 equals, hashCode, toString, copy 메서드를 가진 구조화된 데이터를 저장합니다. Gson이나 kotlinx.serialization 같은 라이브러리는 클래스 프로퍼티를 사용해 JSON 필드를 매핑합니다. 여기서 Data Class를 생성하고 올바른 어노테이션을 추가한 후 Gson.fromJson 또는 Json.decodeFromString으로 역직렬화하세요.

Kotlin에서 Retrofit으로 JSON을 어떻게 파싱하나요?

Retrofit 빌더에 Gson 또는 kotlinx.serialization 변환기 팩토리를 추가한 다음 Data Class 반환 타입으로 API 인터페이스를 정의하세요. 여기서 API 응답으로 Data Class를 생성하고 프로젝트에 붙여넣으면 Retrofit이 역직렬화를 자동으로 처리합니다.

@SerializedName과 @SerialName의 차이는?

@SerializedName은 Gson용으로 JSON 키를 Kotlin 프로퍼티 이름에 매핑합니다. @SerialName은 kotlinx.serialization의 등가물입니다. 사용하는 JSON 라이브러리에 맞는 것을 사용하세요. 둘 다 user_name과 같은 JSON 키를 userName이라는 Kotlin 프로퍼티에 매핑할 수 있습니다.

내 JSON이 서버로 전송되나요?

아니요. Data Class 생성은 완전히 브라우저에서 실행됩니다. JSON이 내 기기를 절대 떠나지 않습니다.

Kotlin Data Class의 nullable 타입?

Nullable Types를 활성화하면 String?, Int? 등이 생성됩니다. JSON 필드가 없거나 null이 될 수 있을 때 유용합니다. Kotlin의 null 안전성은 이러한 케이스 처리를 잊으면 컴파일 오류가 발생합니다.

관련 도구

Kotlin에서 JSON: kotlinx.serializationGson. JSON: JSON 사양, RFC 8259. 개요: MDN.