rzaripov.kz

Список задач на Kotlin с базой Room

В портфеле Равиля Зарипова, разработчика из Алматы, кроссплатформенные проекты занимают центральное место. Его опыт охватывает Android, iOS, Windows, macOS и Linux, а стек включает Delphi, FireMonkey, Kotlin, Swift, PHP и базы данных. Локальный Android-проект хорошо показывает, как эти навыки применяются к небольшому приложению с понятной архитектурой.

Локальный список задач на Kotlin с Room Database начинается с небольшого набора функций: создание, редактирование, отметка выполнения и удаление записей. Каждая задача должна сохраняться между запусками, поэтому приложение получает собственную базу без сервера, учётных записей и синхронизации.

Room берёт на себя создание SQLite-хранилища, проверку запросов во время сборки и преобразование строк в объекты Kotlin. DAO изолирует SQL, репозиторий формирует правила работы с данными, а ViewModel управляет состоянием экрана. Вместе эти слои создают предсказуемый поток: пользователь меняет список, изменения попадают в Room, а Room сообщает интерфейсу о новом содержимом.

В качестве пользовательского интерфейса удобно взять Jetpack Compose: он поддерживает декларативные экраны, реактивное получение данных и проверяемые состояния элементов. Важно удержать пример небольшим: одна сущность, один DAO, репозиторий, модель представления и несколько composable-функций. Такой масштаб позволяет показать полный цикл разработки и качество тестирования.

Подготовка Android-проекта

В модуле приложения нужны room-runtime, room-ktx и компилятор аннотаций Room, подключённый через KSP. Для ViewModel и жизненного цикла добавляются соответствующие библиотеки AndroidX, а для Compose — Material 3 и инструменты тестирования. Версии зависимостей удобно фиксировать в каталоге версий, чтобы во всех модулях использовались совместимые транзитивные библиотеки.

Минимальная структура состоит из пакетов data, domain и ui. В data находятся сущность, DAO и реализация базы; domain хранит правила и репозиторий; ui содержит ViewModel, composable-функции и модели состояния. Экземпляр Room создаётся один раз и передаётся зависимостями в репозиторий, поэтому экраны не открывают соединения с базой самостоятельно.

Модель задачи и локальная база

Сущность Task помечается аннотацией @Entity и описывает одну пользовательскую задачу. В модели достаточно идентификатора, краткого названия, описания, признака выполнения и времени создания. Аннотация @PrimaryKey с параметром autoGenerate = true позволяет Room выдавать числовые идентификаторы без ручного расчёта.

Поле title получает ограничение длины, а createdAt хранит метку времени в миллисекундах. Такое представление легко сортировать и не зависит от локали. Если задачи придётся искать по названию или статусу, для соответствующих столбцов можно добавить индексы Room, не меняя API репозитория.

Класс TaskDatabase помечается аннотацией @Database, содержит версию схемы и ссылается на список сущностей. Для первого запуска достаточно версии 1; последующие изменения схемы потребуют миграции. Реализацию базы обычно создают как одиночный объект с ленивой инициализацией, чтобы не открывать файл SQLite до первого обращения к данным.

Операции над данными

Интерфейс TaskDao содержит методы для получения, вставки, изменения и удаления записей. Метод observeTasks() возвращает Flow<List<Task>>, а запрос SELECT с сортировкой по времени создания определяет порядок элементов. Операции записи объявляются как suspend-функции, поэтому вызовы не блокируют поток интерфейса.

Репозиторий предоставляет приложению понятные методы вроде addTask, updateTask, toggleCompleted и deleteTask. Он скрывает аннотации DAO и может проверять допустимость изменения. Для простого приложения преобразование Entity в отдельную доменную модель необязательно, однако разделение полезно, если бизнес-правила начнут усложняться.

ViewModel получает поток DAO и преобразует его в StateFlow с помощью stateIn. Пользовательские действия запускаются в viewModelScope, а ошибки сохраняются в состоянии экрана. Такой подход отделяет Android-компоненты от способа хранения: интерфейс знает о состоянии, но не управляет SQL-запросами напрямую.

Экран приложения и состояние

Jetpack Compose позволяет собрать список через LazyColumn, отображать название и описание задачи, а завершение показывать с помощью Checkbox. Наблюдение StateFlow выполняется через collectAsStateWithLifecycle, поэтому коллекция приостанавливается, когда экран недоступен. Пустое состояние получает отдельное сообщение вместо пустого контейнера.

Форма создания хранит редактируемый текст в состоянии ViewModel. Перед сохранением название обрезается от лишних пробелов и проверяется на минимальную длину. Ошибка остаётся рядом с полем, а диалог закрывается только после успешной записи в Room. Так пользователь не теряет введённые данные из-за неверного ввода.

Если позже появится очередь автосохранения на акторах, полезно изучить жизненный цикл ресурсов: материал показывает, где освобождать подписки и останавливать фоновые операции. Для базовой версии приложения достаточно жизненного цикла ViewModel и корректного сбора потоков Compose.

Тестирование и надёжность

DAO проверяют инструментальными тестами с базой Room в памяти. Тест создаёт временную базу, вставляет несколько задач, меняет их статус и проверяет порядок результата. Такой сценарий обнаруживает ошибки в запросах, ограничениях и преобразовании типов без запуска полноценного приложения.

Схему Room сохраняют в каталоге исходников проекта. Каждое изменение Entity или структуры таблицы увеличивает версию базы и сопровождается объектом Migration. Проверка через MigrationTestHelper создаёт старую версию схемы, применяет миграцию и сравнивает результат с новой. Удаление данных через fallbackToDestructiveMigration допустимо в учебных прототипах, но не подходит для хранения пользовательских записей.

Одновременные изменения обрабатываются последовательностью Room и транзакциями. Сложные операции, затрагивающие несколько таблиц, помечаются аннотацией @Transaction, чтобы промежуточное состояние не попало в базу. Дополнительно проверяются длинные названия, пустое описание, повторное нажатие кнопки сохранения и выход приложения во время записи.

Сравнение способов хранения

Room подходит для структурированных данных с запросами, но рядом существуют более простые варианты. SharedPreferences рассчитан на настройки, прямая работа с SQLite требует ручного управления курсорами и SQL, а JSON-файл удобен для небольшого экспорта. Эти варианты сравниваются по основному назначению, проверке запросов, реактивности и рискам.

Критерий Room SharedPreferences Прямой SQLite JSON-файл
Основное назначение Структурированные задачи с запросами Настройки и простые значения Ручное управление SQL и схемой Небольшие архивы или экспорт
Проверка запросов Во время сборки Не предусмотрена На стороне разработчика На стороне приложения
Реактивные обновления Flow и LiveData Слушатели изменений Собственные механизмы Перечитывание файла
Сложность Средняя Низкая Высокая Низкая для чтения
Главный риск Схема и миграции Ограниченный набор данных Ошибки и дублирование кода Слабые запросы и конкурентная запись

Для выбранного набора функций Room занимает разумную середину: он скрывает ручной SQL, проверяет DAO при компиляции и предоставляет реактивный поток. SharedPreferences здесь недостаточно выразителен, прямой SQLite увеличит объём служебного кода, а JSON усложнит поиск, обновление и защиту целостности данных.

Готовый проект можно собрать в debug- и release-вариантах, снабдить значком, опубликовать исходный код и показать результаты тестов в профиле GitHub. В портфеле Равиля Зарипова такой Android-кейс органично продолжает линию кроссплатформенной разработки и подтверждает умение связывать локальное хранение, интерфейс и жизненный цикл приложения в единый рабочий продукт.