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

20sp
3dp
Создание класса базы данных
Классы-сущности определяют структуру таблиц базы данных.
Один класс-сущность может использоваться в нескольких базах
данных, если у вашего приложения их несколько. Это редкая,
но возможная ситуация. По этой причине такие классы не
используются Room для создания таблицы, если вы явно не
свяжете их его с базой данных, что мы и сделаем в ближайшее
время.
Во-первых, нужно создать новый пакет под названием
database
для связанного с базой данных кода. На панели
Project
щелкните правой кнопкой мыши по папке
com.bignerdranch.android.criminalintent
и выберите
команду 
New
⇒
Package
в контекстном меню. Назовите свой
новый пакет 
database
.
Теперь создайте новый класс 
CrimeDatabase
в пакете
database
и определите класс, как показано ниже.
Листинг 11.3. Инициализация класса CrimeDatabase
(database/CrimeDatabase.kt)
@Database(entities 
= 
[ 
Crime::class 
],
version=1)
abstract class CrimeDatabase : RoomDatabase() {
}

---

Аннотация 
@Database
сообщает Room о том, что этот класс
представляет собой базу данных в приложении. Самой
аннотации требуется два параметра. Первый параметр — это
список классов-сущностей, который сообщает Room, какие
использовать классы при создании и управлении таблицами
для этой базы данных. В нашем случае мы передаем только
класс 
Crime
, так как это единственная сущность в приложении.
Второй параметр — версия базы данных. При первом
создании базы данных версия должна быть равна 1. При
будущей разработке приложения вы можете добавлять новые
сущности и новые свойства существующим сущностям. В этом
случае вам нужно будет изменить список сущностей и
увеличить версию базы данных, чтобы обозначить факт
изменения (мы сделаем это в главе 15).
Сам класс базы данных пока пустой. 
CrimeDatabase
расширяется от 
RoomDatabase
и помечается как абстрактный,
так что вы не можете создать экземпляр непосредственно от
него. Вы узнаете, как использовать Room, чтобы получить
пригодный для использования экземпляр базы данных, позже в
этой главе.