Android. Программирование для профессионалов. 4-е издание

20sp
3dp
Библиотека компонентов архитектуры Room
Room — это библиотека компонентов архитектуры Jetpack,
позволяющая упростить настройку и доступ к базе данных. Она
помогает определить структуру базы данных и запросов с
помощью аннотированных классов Kotlin.
Room состоит из API, аннотаций и компилятора. API
содержит классы, которые вы будете расширять для
определения базы данных и создания ее экземпляра. Вы
можете использовать аннотации, чтобы указать, например, что
должно быть сохранено в базе данных, какой класс
представляет вашу базу данных и какой класс определяет
функцию доступа к таблицам базы данных. Компилятор
обрабатывает 
аннотированные 
классы 
и 
генерирует
реализацию базы данных.
Чтобы использовать Room, сначала нужно добавить
необходимые зависимости. Добавьте зависимости 
room-
runtime
и 
room-compiler
в файл 
app/build.gradle
.

---

Листинг 11.1. Добавление зависимостей (app/build.gradle)
apply plugin: 'kotlin-android-extensions'
apply plugin: 'kotlin-kapt'
android {
...
}
...
dependencies {
...
implementation 'androidx.core:core-
ktx:1.1.0-alpha04'
implementation 'androidx.room:room-
runtime:2.1.0-alpha04'
kapt 'androidx.room:room-compiler:2.1.0-
alpha04'
...
}
В верхней части файла мы добавили новый плагин Android
Studio. Плагины позволяют добавить IDE новые функции.
Перейдите по ссылке 
plugins.jetbrains.com/androidstudio
, где вы
найдете много новых плагинов, которые можно добавить.
kotlin-kapt
означает «инструмент обработки аннотаций
Kotlin». Когда библио тека генерирует код, вам наверняка
захочется 
использовать эти сгенерированные классы
непосредственно 
в 
коде. 
Но 
по 
умолчанию 
эти
сгенерированные классы не видны в Android Studio, так что при
попытке импорта вы увидите сообщение об ошибке.
Добавление плагина 
kotlin-kapt
реализует поддержку

---

сгенерированных файлов в Android Studio, поэтому вы можете
импортировать их в свои классы.
Первая добавленная вами зависимость 
room-runtime
предназначена для API Room, содержащего все классы и
аннотации, которые вам потребуются для определения базы
данных. Вторая зависимость, 
room-compiler
, нужна для
компилятора Room, который будет генерировать вашу
реализацию базы данных на основе заданных аннотаций.
Компилятор использует ключевое слово 
kapt
вместо
implementation
, поэтому сгенерированные классы от
компилятора открыты для Android Studio благодаря плагину
kotlin-kapt
.
Не забудьте синхронизировать ваши файлы Gradle. Теперь
мы можем перейти к подготовке слоя модели для хранения в
базе данных.