Room Database

Room Database — это объектно-реляционная обёртка над SQLite, которая:

• генерирует код для операций CRUD (Create, Read, Update, Delete) на основании аннотаций в исходном коде;
• проверяет SQL-запросы на этапе компиляции, снижая вероятность ошибок во время выполнения;
• поддерживает реактивные типы данных (LiveData, Flow) и асинхронные вызовы (suspend-функции);
• автоматически сопоставляет (маппирует) поля классов с столбцами таблиц^[1].

Room состоит из трёх основных компонентов:

1. Entity — класс-модель, представляющий таблицу в базе данных. Каждое поле объекта соответствует столбцу таблицы.
2. DAO (Data Access Object) — интерфейс или абстрактный класс, содержащий методы для SQL-операций; Room генерирует их реализации при сборке.
3. RoomDatabase — абстрактный класс, расширяющий RoomDatabase; через него приложение получает экземпляры DAO и доступ к базе.

• Аннотация @Entity помечает класс как таблицу; одно из полей обязательно помечается @PrimaryKey для уникальной идентификации записей^[2].
• Для переименования столбцов используется @ColumnInfo(name = "..."), а для исключения поля — @Ignore.
• Поддерживаются внешние ключи через @ForeignKey, что позволяет описывать отношения между таблицами^[3].

• DAO помечается аннотацией @Dao и содержит методы с аннотациями @Insert, @Update, @Delete или @Query^[4].
• Room проверяет корректность SQL-запросов при компиляции и генерирует типобезопасные реализации.
• Методы DAO могут возвращать LiveData, Flow, PagingSource или suspend-результаты.

• Класс помечается аннотацией @Database, где перечисляются все Entity и версия схемы.
• Обычно реализуется как синглтон, создаваемый через Room.databaseBuilder() или Room.inMemoryDatabaseBuilder().
• В аннотации рекомендуется устанавливать exportSchema = true и задавать путь для room.schemaLocation, чтобы Room сохранял JSON-описания схемы для миграций^[5].

Работа с Room Database включает несколько последовательных этапов, каждый из которых обеспечивает корректную интеграцию и эксплуатацию базы данных в Android-приложении.

На этом этапе определяются сущности (Entity), их связи, методы DAO и стратегия версионирования базы данных. Также выбирается схема интеграции с архитектурными компонентами, такими как ViewModel и Repository.

Создаются классы Entity и интерфейсы DAO с необходимыми аннотациями. Для асинхронной работы методы DAO могут быть объявлены как suspend или возвращать типы Flow/LiveData, что позволяет эффективно работать с потоками данных.

Настраивается основной класс RoomDatabase, включается экспорт схемы (exportSchema), реализуется паттерн синглтон для безопасного доступа к базе данных. При необходимости реализуется предварительное заполнение (pre-populate) данных.

• Простые изменения, такие как добавление столбцов или таблиц, можно описать через AutoMigration, указав новую версию и параметр @AutoMigration.
• Для сложных изменений требуется создание отдельного класса Migration с необходимыми SQL-скриптами.
• Для проверки корректности миграций используется MigrationTestHelper.

• Тестирование DAO и миграций проводится в androidTest с использованием in-memory базы данных^[6].
• Для повышения производительности применяются индексы (@Index), выборка только необходимых столбцов, использование paginated-запросов и асинхронное выполнение операций^[3].

• Проверка SQL-запросов во время компиляции, что сокращает количество ошибок рантайма.
• Значительное снижение объёма шаблонного кода за счёт аннотаций.
• Широкая интеграция с компонентами Jetpack (LiveData, Flow, Paging, ViewModel).
• Удобные механизмы миграции и экспорт схемы.
• Возможность кэшировать данные для офлайн-доступа^[1].

• Сложная работа с отношениями «один-ко-многим» и «многие-ко-многим» — требуется создание дополнительных сущностей или POJO с @Relation^[7].
• Ограничена наследуемыми ограничениями SQLite (например, максимум 999 привязок в запросе).
• Room не поддерживает произвольные INSERT-запросы; методы @Insert всегда возвращают Long rowId^[8].
• При больших объектах возможны ошибки OOM; требуется осторожная работа с крупными строками и списками.
• Крутая кривая обучения для начинающих из-за множества аннотаций и правил.

Room используется в Android-приложениях для:

• кэширования сетевых данных и обеспечения офлайн-доступа;
• хранения пользовательских настроек, списков задач, медиа-каталогов;
• управления сложными взаимосвязанными данными (например, заметки и теги, книги и авторы);
• реализации шаблона «Repository» при архитектуре MVVM, когда локальное хранилище комбинируется с сетевыми источниками.

• Официальный Room KTX-модуль для сопрограмм и Flow.
• Room Gradle Plugin (начиная с версии 2.6.0) — упрощает настройку schemaLocation и кэшируемых сборок.
• Room Explorer — библиотека для просмотра содержимого базы непосредственно в приложении.
• Stitch и другие генераторы репозиториев, снижающие бойлерплейт-код DAO.

• Gradle-плагины kapt или ksp для обработки аннотаций Room; KSP рекомендуется для Kotlin-проектов из-за лучшей производительности.
• Параметр room.schemaLocation в build.gradle для экспорта схемы в JSON.

• Плагины для генерации ER-диаграмм из экспортированных схем.
• SQLCipher или Encrypted File API для шифрования базы данных на устройствах с повышенными требованиями безопасности.
• Интеграционные библиотеки для Dagger / Hilt, упрощающие внедрение RoomDatabase как зависимости.

Room естественно встраивается в архитектуру MVVM:

• ViewModel получает данные из Repository, который обращается к DAO;
• DAO-методы могут возвращать LiveData или Flow, автоматически уведомляющие UI об изменениях;
• при работе с большими наборами данных используется Paging 3 — DAO возвращает PagingSource, а UI отображает PagingData внутри RecyclerView или Jetpack Compose-элементов^[9].