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

20sp
3dp
Создание базы данных
Создание базы данных с помощью Room делается в три этапа:
• аннотирование класса модели, чтобы сделать его сущностью
базы данных;
• создание класса, который будет представлять саму базу
данных;
• создание конвертера типа, позволяющего базе данных
обрабатывать ваши данные модели.
Room позволяет выполнить все эти три шага легким
движением руки.

---

Определение сущностей
Room создает структуру таблицы базы данных для приложения,
основываясь на определенных вами сущностях. Сущности —
это классы моделей, аннотированные аннотацией 
@Entity
.
Room создаст таблицу базы данных для любого класса с такой
аннотацией.
Поскольку вы хотите хранить в базе данных преступления,
объект 
Crime
должен быть сущностью Room. Откройте файл
Crime.kt
и добавьте две аннотации.
Листинг 11.2. Превращаем Crime в сущность (Crime.kt)
@Entity
data class Crime(@PrimaryKey val id: UUID =
UUID.randomUUID(),
var title: String = "",
var date: Date = Date(),
var isSolved: Boolean = false)
Первая аннотация, 
@Entity
, применяется на уровне класса.
Эта аннотация указывает, что класс определяет структуру
таблицы или набора таблиц в базе данных. В этом случае
каждая строка в таблице будет представлять собой отдельные
преступления. Каждое свойство, определенное в классе,
превратится в столбец в таблице, при этом имя свойства станет
именем столбца. В нашем случае у таблицы будет четыре
столбца: 
id
, 
title
, 
date
и 
isSolved
.
Вторая добавленная нами аннотация — это 
@PrimaryKey
,
которую вы добавили к свойству 
id
. Эта аннотация указывает,
какой столбец в базе данных является первичнымключом.
Первичный ключ в базе данных — это такой столбец, который
содержит данные, уникальные для каждой записи или строки.

---

Такой столбец можно использовать для вызова отдельных
записей. Свойство 
id
уникально для каждого преступления,
поэтому добавление 
@PrimaryKey
для этого свойства
позволяет запрашивать преступления по идентификатору.
Теперь у класса 
Crime
есть нужные аннотации, и вы можете
переходить к созданию вашего класса базы данных.