Skip to content

직렬화(Serialization) ​

직렬화(Serialization)는 애플리케이션에서 사용되는 데이터를 네트워크를 통해 전송하거나 데이터베이스 또는 파일에 저장할 수 있는 형식으로 변환하는 프로세스입니다. 역직렬화(Deserialization)는 외부 데이터를 다시 런타임 객체로 변환하는 반대 프로세스입니다. 이 둘은 서드파티와 데이터를 주고받는 대부분의 애플리케이션에서 필수적입니다.

JSON 및 Protocol Buffers와 같은 일부 데이터 직렬화 형식은 특히 널리 사용됩니다. 이러한 형식은 언어 중립적이고 플랫폼 중립적이므로, 최신 언어로 작성된 시스템 간에 데이터를 교환하는 데 사용할 수 있습니다. Kotlin은 멀티플랫폼 및 다양한 데이터 형식을 지원하는 kotlinx.serialization 라이브러리를 통해 이 기능을 제공합니다.

Kotlin의 직렬화가 처음이라면 직렬화 시작하기(Get Started with Serialization) 튜토리얼부터 시작하는 것을 권장합니다. 이 튜토리얼에서는 프로젝트에 Kotlin 직렬화를 설정하는 과정을 안내하고, 첫 번째 클래스를 직렬화 및 역직렬화하는 방법을 보여줍니다.

Get started with serialization

Kotlin 직렬화 라이브러리 ​

Kotlin 직렬화는 JVM, JavaScript, Native를 포함한 모든 플랫폼을 지원합니다. 대상 플랫폼에 관계없이 동일한 의존성 선언을 사용할 수 있습니다.

Kotlin 직렬화는 다양한 직렬화 포맷 라이브러리를 통해 JSON, CBOR, Protocol Buffers 등 여러 직렬화 형식을 지원합니다. 이 라이브러리들은 kotlinx-serialization-core 라이브러리를 기반으로 빌드됩니다. 지원되는 직렬화 형식의 전체 목록은 지원되는 직렬화 형식을 참조하세요.

모든 kotlinx.serialization 포맷 라이브러리는 org.jetbrains.kotlinx: 그룹의 일부이며, kotlinx-serialization-으로 시작하고 직렬화 형식을 반영하는 접미사가 붙는 이름을 가집니다. 예를 들면 다음과 같습니다.

  • org.jetbrains.kotlinx:kotlinx-serialization-json: JSON 직렬화를 제공합니다.
  • org.jetbrains.kotlinx:kotlinx-serialization-cbor: CBOR 직렬화를 제공합니다.

kotlinx.serialization 라이브러리는 Kotlin과 독립적인 자체 버전 관리를 따릅니다. 최신 릴리스 버전은 GitHub에서 확인할 수 있습니다.

사용자 정의 직렬화 형식을 직접 작성하는 경우와 같이 특정 형식 라이브러리를 사용하지 않는 경우에는 kotlinx-serialization-core 라이브러리를 의존성으로 사용하세요.

지원되는 직렬화 형식 ​

kotlinx.serialization 프로젝트는 다양한 직렬화 형식을 위한 라이브러리를 제공합니다.

형식아티팩트 ID플랫폼상태
JSONkotlinx-serialization-json지원되는 모든 플랫폼안정(Stable)
HOCONkotlinx-serialization-hoconJVM 전용실험적(Experimental)
Protocol Bufferskotlinx-serialization-protobuf지원되는 모든 플랫폼실험적(Experimental)
CBORkotlinx-serialization-cbor지원되는 모든 플랫폼실험적(Experimental)
Propertieskotlinx-serialization-properties지원되는 모든 플랫폼실험적(Experimental)

JSON 직렬화 라이브러리(kotlinx-serialization-json)를 제외한 모든 직렬화 포맷 라이브러리는 실험적(Experimental) 단계입니다. 이들의 API는 언제든지 변경될 수 있습니다. JSON 직렬화에 대한 자세한 내용은 JSON 직렬화 개요를 참조하세요.

YAML이나 Apache Avro와 같은 추가 직렬화 형식을 지원하는 커뮤니티 유지 관리 라이브러리도 있습니다.

대체 형식 및 커스텀 실험적 직렬화 형식에 대한 자세한 내용은 커스텀 직렬화 형식에서 확인할 수 있습니다.

지원되는 직렬화 타입 ​

Kotlin 직렬화는 모든 원시 타입(primitive types)과 List 타입과 같은 Kotlin 표준 라이브러리의 대부분의 복합 타입(composite types)을 포함하여 다양한 내장 타입을 지원합니다. 자세한 내용은 내장 타입 직렬화를 참조하세요.

또한, @Serializable 어노테이션이 지정된 클래스는 직렬화가 완벽히 지원되므로 클래스 인스턴스를 JSON과 같은 형식으로 상호 변환할 수 있습니다. 자세한 내용은 클래스 직렬화를 참조하세요.

다음 단계 ​