Skip to content

데이터 클래스

코틀린의 데이터 클래스는 주로 데이터를 담는 데 사용됩니다. 각 데이터 클래스에 대해 컴파일러는 인스턴스를 읽기 쉬운 출력으로 인쇄하고, 인스턴스를 비교하고, 인스턴스를 복사하는 등의 추가적인 멤버 함수를 자동으로 생성합니다. 데이터 클래스는 data로 표시됩니다.

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

컴파일러는 주 생성자에 선언된 모든 프로퍼티로부터 다음 멤버를 자동으로 파생시킵니다.

  • equals()/hashCode() 쌍.
  • "User(name=John, age=42)" 형태의 toString().
  • 선언 순서에 따라 프로퍼티에 해당하는 componentN() 함수.
  • copy() 함수 (아래 참조).

생성된 코드의 일관성과 의미 있는 동작을 보장하기 위해 데이터 클래스는 다음 요구 사항을 충족해야 합니다.

  • 주 생성자는 하나 이상의 매개변수를 가져야 합니다.
  • 모든 주 생성자 매개변수는 val 또는 var로 표시되어야 합니다.
  • 데이터 클래스는 abstract, open, sealed, inner일 수 없습니다.

또한, 데이터 클래스 멤버 생성은 멤버의 상속과 관련하여 다음 규칙을 따릅니다.

  • 데이터 클래스 본문에 equals(), hashCode(), 또는 toString()의 명시적 구현이 있거나 슈퍼클래스에 final 구현이 있는 경우, 이 함수들은 생성되지 않고 기존 구현이 사용됩니다.
  • 상위 타입에 open이며 호환 가능한 타입을 반환하는 componentN() 함수가 있는 경우, 해당 함수는 데이터 클래스용으로 생성되고 상위 타입의 함수를 오버라이드합니다. 상위 타입의 함수가 호환되지 않는 시그니처 또는 final이기 때문에 오버라이드될 수 없는 경우, 오류가 보고됩니다.
  • componentN()copy() 함수에 대한 명시적 구현을 제공하는 것은 허용되지 않습니다.

데이터 클래스는 다른 클래스를 상속할 수 있습니다(예시는 봉인된 클래스를 참조하세요).

JVM에서, 생성된 클래스가 매개변수 없는 생성자를 가져야 하는 경우, 프로퍼티의 기본값이 지정되어야 합니다(생성자 참조).

kotlin
data class User(val name: String = "", val age: Int = 0)

클래스 본문에 선언된 프로퍼티

컴파일러는 자동으로 생성된 함수에 대해 주 생성자 내부에 정의된 프로퍼티만 사용합니다. 생성된 구현에서 프로퍼티를 제외하려면 클래스 본문 내부에 선언하십시오.

kotlin
data class Person(val name: String) {
    var age: Int = 0
}

아래 예시에서 toString(), equals(), hashCode(), copy() 구현 내부에서는 기본적으로 name 프로퍼티만 사용되며, component1()이라는 컴포넌트 함수가 하나만 있습니다. age 프로퍼티는 클래스 본문 내부에 선언되었으며 제외됩니다. 따라서 equals()가 주 생성자의 프로퍼티만 평가하기 때문에 name은 같지만 age 값은 다른 두 Person 객체는 동일하게 간주됩니다.

kotlin
data class Person(val name: String) {
    var age: Int = 0
}
fun main() {
    val person1 = Person("John")
    val person2 = Person("John")
    person1.age = 10
    person2.age = 20

    println("person1 == person2: ${person1 == person2}")
    // person1 == person2: true
  
    println("person1 with age ${person1.age}: ${person1}")
    // person1 with age 10: Person(name=John)
  
    println("person2 with age ${person2.age}: ${person2}")
    // person2 with age 20: Person(name=John)
}

복사

copy() 함수를 사용하여 객체를 복사하면 프로퍼티 중 _일부_를 변경하면서 나머지는 변경되지 않은 상태로 유지할 수 있습니다. 위의 User 클래스에 대한 이 함수의 구현은 다음과 같습니다.

kotlin
fun copy(name: String = this.name, age: Int = this.age) = User(name, age)

그러면 다음과 같이 작성할 수 있습니다.

kotlin
val jack = User(name = "Jack", age = 1)
val olderJack = jack.copy(age = 2)

데이터 클래스와 구조 분해 선언

데이터 클래스용으로 생성된 _컴포넌트 함수_는 구조 분해 선언에서 사용할 수 있게 합니다.

kotlin
val jane = User("Jane", 35)
val (name, age) = jane
println("$name, $age years of age") 
// Jane, 35 years of age

표준 데이터 클래스

표준 라이브러리는 PairTriple 클래스를 제공합니다. 하지만 대부분의 경우, 이름 있는 데이터 클래스는 프로퍼티에 의미 있는 이름을 제공하여 코드를 더 읽기 쉽게 만들기 때문에 더 나은 설계 선택입니다.