Какие знаешь основные компоненты в Room?

Основные компоненты Room Persistence Library

Room — это абстракция над SQLite, предоставляемая Android Jetpack, которая упрощает работу с базой данных. Вот ключевые компоненты, которые образуют архитектуру Room:

1. Entity (Сущность)

Класс, аннотированный @Entity, представляет таблицу в базе данных. Каждый экземпляр класса — строка в таблице.

@Entity(tableName = "users")
data class User(
    @PrimaryKey(autoGenerate = true)
    val id: Long = 0,
    
    @ColumnInfo(name = "user_name")
    val userName: String,
    
    @ColumnInfo(name = "email")
    val email: String,
    
    @ColumnInfo(name = "age")
    val age: Int
)

Основные аннотации Entity:

• @Entity — отмечает класс как таблицу
• @PrimaryKey — определяет первичный ключ
• @ColumnInfo — кастомизация столбцов (имя, тип)
• @Ignore — исключает поле из таблицы
• @Embedded — вложение объектов
• Индексы через @Entity(indices = [...])

2. DAO (Data Access Object)

Интерфейс или абстрактный класс с аннотацией @Dao, содержащий методы для доступа к базе данных. Определяет CRUD-операции и запросы.

@Dao
interface UserDao {
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun insert(user: User)
    
    @Update
    suspend fun update(user: User)
    
    @Delete
    suspend fun delete(user: User)
    
    @Query("SELECT * FROM users")
    suspend fun getAll(): List<User>
    
    @Query("SELECT * FROM users WHERE id = :userId")
    suspend fun getById(userId: Long): User?
    
    @Query("DELETE FROM users WHERE age < :minAge")
    suspend fun deleteYoungerThan(minAge: Int): Int
}

Ключевые аннотации DAO:

• @Insert, @Update, @Delete — базовые операции
• @Query — произвольные SQL-запросы
• @Transaction — обертка для транзакций
• @RawQuery — для динамических запросов

3. Database (База данных)

Абстрактный класс, расширяющий RoomDatabase, который служит основной точкой доступа к базе данных. Он связывает Entity с DAO.

@Database(
    entities = [User::class, Post::class],
    version = 1,
    exportSchema = true
)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
    abstract fun postDao(): PostDao
    
    companion object {
        @Volatile
        private var INSTANCE: AppDatabase? = null
        
        fun getInstance(context: Context): AppDatabase {
            return INSTANCE ?: synchronized(this) {
                val instance = Room.databaseBuilder(
                    context.applicationContext,
                    AppDatabase::class.java,
                    "app_database"
                ).build()
                INSTANCE = instance
                instance
            }
        }
    }
}

Особенности Database класса:

• Аннотация @Database с указанием entities и версии
• Абстрактные методы для каждого DAO
• Использование паттерна Singleton для доступа
• Поддержка миграций через addMigrations()
• Возможность вызова деструктивных операций fallbackToDestructiveMigration()

Дополнительные важные компоненты

TypeConverters

Позволяют сохранять сложные типы данных (Date, List, Enum) в SQLite.

class Converters {
    @TypeConverter
    fun fromTimestamp(value: Long?): Date? {
        return value?.let { Date(it) }
    }
    
    @TypeConverter
    fun dateToTimestamp(date: Date?): Long? {
        return date?.time
    }
}

Relationships

Связи между таблицами через @Relation, @ForeignKey и вложенные запросы.

data class UserWithPosts(
    @Embedded val user: User,
    @Relation(
        parentColumn = "id",
        entityColumn = "authorId"
    )
    val posts: List<Post>
)

Миграции (Migrations)

Обеспечивают безопасное изменение схемы базы данных между версиями.

val MIGRATION_1_2 = object : Migration(1, 2) {
    override fun migrate(database: SupportSQLiteDatabase) {
        database.execSQL("ALTER TABLE users ADD COLUMN phone TEXT")
    }
}

Практические рекомендации

Архитектурные советы:

• Всегда используйте suspend-функции или RxJava/Flow для асинхронных операций
• Инжектируйте зависимости через Dagger/Hilt для тестирования
• Размещайте DAO интерфейсы ближе к репозиториям в Clean Architecture
• Используйте Room + Paging 3 для эффективной пагинации

Производительность:

• Избегайте запросов в основном потоке
• Используйте индексы для часто фильтруемых полей
• Применяйте @Transaction для групповых операций
• Рассмотрите @RawQuery для сложных динамических запросов

Room существенно снижает boilerplate-код при работе с SQLite, обеспечивая compile-time проверку SQL-запросов и seamless интеграцию с другими компонентами Jetpack (LiveData, ViewModel, Paging). Правильное использование этих компонентов создает надежный, тестируемый и производительный слой данных в Android-приложении.