Какие классы помечаются словом data

Ответ на вопрос: Какие классы помечаются словом data в Kotlin?

Ключевое слово data в Kotlin применяется специально к классам (class). Его основная цель — автоматическая генерация полезных стандартных функций для классов, которые предназначены преимущественно для хранения данных. Такие классы часто называют «data classes» или классами данных.

Основные условия и характеристики Data Class

Класс объявляется как data class при соблюдении следующих требований:

1. Основное назначение — хранить данные. Его свойства (поля) обычно являются val или var.
2. Конструктор класса должен иметь как минимум один параметр. Это обязательное условие.
3. Все параметры основного конструктора должны быть явно объявлены как val или var. Параметры без модификаторов не допускаются.
4. Data class не может быть abstract, open, sealed или inner. Однако он может быть финализирован (final) или наследоваться от других классов, а также реализовывать интерфейсы.
5. До версии Kotlin 1.1 data class не мог наследоваться от других data classes. Сейчас это разрешено.

Пример объявления data class:

// Правильное объявление data class
data class User(
    val id: Long,
    val name: String,
    var email: String // var также допустим
)

// НЕПРАВИЛЬНО: конструктор без параметров
// data class Empty() // Ошибка компиляции

// НЕПРАВИЛЬНО: параметр без val/var
// data class Invalid(id: Long) // Ошибка компиляции

Автоматически генерируемые функции

При объявлении класса с ключевым словом data компилятор Kotlin автоматически создает следующие функции, основанные на свойствах основного конструктора:

1. .equals() / == — Сравнение по содержимому. Две сущности data class считаются равными, если равны все их свойства основного конструктора.
2. .hashCode() — Генерируется согласованно с .equals().
3. .toString() — Возвращает строку в удобном формате: User(id=1, name=Anna, email=anna@mail.com).
4. .copy() — Позволяет создать копию объекта, с возможностью изменения части свойств. Это крайне полезно для immutable подходов.
5. Компонентные функции .componentN() — Функции для деструктуризации (destructuring declaration). Позволяют «разбирать» объект на отдельные значения.

Пример использования автоматически сгенерированных функций:

fun main() {
    val user1 = User(1, "Anna", "anna@mail.com")
    val user2 = User(1, "Anna", "anna@mail.com")
    val user3 = User(2, "Ivan", "ivan@mail.com")

    // .equals() / ==
    println(user1 == user2) // true, свойства идентичны
    println(user1 == user3) // false, id разные

    // .toString()
    println(user1) // Вывод: User(id=1, name=Anna, email=anna@mail.com)

    // .copy()
    val updatedUser = user1.copy(email = "newanna@mail.com")
    println(updatedUser) // User(id=1, name=Anna, email=newanna@mail.com)

    // Деструктуризация через .componentN()
    val (id, name, email) = user1
    println("id=$id, name=$name, email=$email") // id=1, name=Anna, email=anna@mail.com
}

Что НЕ генерируется автоматически?

• Генерация методов для свойств, объявленных вне основного конструктора. Автоматические функции работают только с параметрами основного конструктора. Свойства, объявленные в теле класса, игнорируются в .equals(), .hashCode(), .toString() и .copy().
• .clone() — Метод для глубокого клонирования не предоставляется, используйте .copy().

data class Person(val firstName: String) {
    var age: Int = 0 // Это свойство НЕ учитывается в автоматических функциях!
}

fun main() {
    val p1 = Person("Alex")
    p1.age = 25
    val p2 = Person("Alex")
    p2.age = 30

    println(p1 == p2) // true, потому что сравнивается только firstName!
    println(p1) // Person(firstName=Alex) - age не отображается
}

Практическое применение в Android Development

Data classes невероятно полезны в Android разработке, особенно при работе с:

• Модели данных (DTO, Entity) для REST API, базы данных (Room), или передачи между слоями приложения (например, в Clean Architecture).
• Аргументы передачи между компонентами (например, в Bundle, Intent или аргументы Navigation Component в Jetpack).
• Состояние в State Management (например, состояние ViewModel в MVI или MVVM).
• Коллекции и преобразования данных в сочетании с функциональными операциями Kotlin (map, filter, groupBy).

Пример использования с Room Entity:

@Entity(tableName = "notes")
data class NoteEntity(
    @PrimaryKey(autoGenerate = true)
    val id: Long = 0,
    @ColumnInfo(name = "title")
    val title: String,
    @ColumnInfo(name = "content")
    val content: String,
    @ColumnInfo(name = "created_at")
    val createdAt: Date
)

Итог

Ключевое слово data помечает классы Kotlin, которые служат контейнерами данных. Компилятор автоматически генерирует для них стандартные методы (equals, hashCode, toString, copy, componentN`), значительно сокращая boilerplate код и повышая читаемость, безопасность и удобство работы с объектами-данными. Это одна из фундаментальных и самых популярных особенностей языка Kotlin, широко используемая в современной Android разработке.