Использование Java-записей в Kotlin
Записи — это классы в Java для хранения неизменяемых данных. Записи содержат фиксированный набор значений — компоненты записи. Они имеют компактный синтаксис в Java и экономят на написании шаблонного кода:
// Java
public record Person (String name, int age) {}
Компилятор автоматически генерирует финальный класс, унаследованный от java.lang.Record со следующими членами:
приватное конечное поле для каждого компонента записи
публичный конструктор с параметрами для всех полей
набор методов для реализации структурного равенства:
equals(),hashCode(),toString()публичный метод для чтения каждого компонента записи
Записи очень похожи на Kotlin классы данных.
Использование Java-записей из кода Kotlin
Вы можете использовать классы-записи с компонентами, объявленными в Java, так же, как вы используете классы со свойствами в Kotlin. Для доступа к компоненту записи просто используйте его имя, как вы делаете для свойств Kotlin:
val newPerson = Person("Kotlin", 10)
val firstName = newPerson.name
Объявление записей в Kotlin
Kotlin поддерживает объявление записей только для классов данных, и класс данных должен соответствовать требованиям.
Чтобы объявить класс-запись в Kotlin, используйте аннотацию @JvmRecord.
@JvmRecord data class Person(val name: String, val age: Int)
Эта JVM-специфичная аннотация позволяет генерировать:
компоненты записи, соответствующие свойствам класса в файле класса
методы доступа к свойствам, именованные в соответствии с соглашением об именах Java-записей
Класс данных предоставляет equals(), hashCode(), и toString() реализации методов.
Требования
Чтобы объявить класс данных с аннотацией @JvmRecord, он должен соответствовать следующим требованиям:
Класс должен находиться в модуле, ориентированном на байт-код JVM 16 (или 15, если включён параметр компилятора
-Xjvm-enable-preview).Класс не может явно наследоваться от другого класса (включая
Any) , поскольку все JVM-записи неявно наследуютjava.lang.Record. Однако класс может реализовывать интерфейсы.Класс не может объявлять свойств с дополнительными полями, за исключением тех, которые инициализированы из соответствующих параметров первичного конструктора.
Класс не может объявлять какие-либо изменяемые свойства с дополнительными полями.
Класс не может быть локальным.
Первичный конструктор класса должен быть такой же видимости, как и сам класс.
Включение JVM-записей
JVM-записи требуют версии целевой JVM или более высокой версии сгенерированного байткода.
Для явного указания используйте параметр компилятора jvmTarget в Gradle или Maven.
Дополнительное обсуждение
Посмотрите это предложение по языку для JVM-записей для получения дополнительных технических подробностей и обсуждения.
© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/jvm-records.html
