手把手教你玩轉Room：Android數據庫的保命指南

作者：Reathin 2025-04-09 08:21:10

聽說你要搞Android本地數據庫？別慌！Room這貨就是官方給的救命稻草，不用再被原生SQLite虐到脫發了。今天咱們用簡單的方式，掰開揉碎了講講這玩意兒怎么玩，保你半小時上手！

三大金剛（核心組件）

數據身份證（Entity）

這玩意兒就是數據庫里的表格模板，用注解就能搞事情。舉個栗子：

@Entity(tableName = "肥宅快樂表")  // 表名隨便起
dataclass 宅男(
    @PrimaryKey(autoGenerate = true)
    val 編號: Int = 0,  // 自動生成主鍵
    
    @ColumnInfo(name = "江湖稱號")// 給字段起花名
    val 昵稱: String,
    
    val 年齡: Int,
    
    @ColumnInfo(defaultValue = "false")
    val 是否單身: Boolean
)

//??

@Entity(tableName = "Otaku")
dataclass Otaku(
    @PrimaryKey(autoGenerate = true)
    val id: Int = 0,
    @ColumnInfo(name = "name")
    val name: String, 
    val age: Int,
    @ColumnInfo(defaultValue = "false")
    val isSingle: Boolean
)

小貼士：@Index可以給常用字段加速，但別亂加，跟吃蛋白粉一樣適量才好

專屬服務員（DAO）

定義怎么調戲數據庫，增刪改查都能整：

@Dao
interface 宅男管家 {
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspendfun 新增宅男(宅男: 宅男)

    @Query("SELECT * FROM 肥宅快樂表 WHERE 是否單身 = 1")
    fun 查所有單身狗(): Flow<List<宅男>>
}

//??

@Dao
interface OtakuDao {
    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspendfun insert(otaku: Otaku)

    @Query("SELECT * FROM Otaku WHERE isSingle = 1")
    fun getSingleOtakus(): Flow<List<Otaku>> 
}

數據城堡（Database）

管著整個數據庫的家當：

@Database(entities = [宅男::class], version = 1)
abstract class 宅男宇宙 : RoomDatabase() {
    abstract fun 管家(): 宅男管家
}

//??

@Database(entities = [Otaku::class], version = 1)
abstract class OtakuDatabase : RoomDatabase() {
    abstract fun otakuDao(): OtakuDao // 保持管家服務
}

實例教學

第一步：加裝備胎

在module的build.gradle里塞這些：

dependencies {
    // 基礎三件套
    implementation "androidx.room:room-runtime:2.6.1"
    kapt "androidx.room:room-compiler:2.6.1"
    implementation "androidx.room:room-ktx:2.6.1"
    
    // 可選外掛
    implementation "androidx.room:room-paging:2.6.1" // 分頁加載
    implementation "androidx.room:room-rxjava3:2.6.1" // 給RxJava愛好者
}

第二步：搞點事情

在ViewModel里調戲數據庫：

class 宅男管理局(privateval 管家: 宅男管家) : ViewModel() {
    // 實時監控所有單身狗
    val 單身貴族: Flow<List<宅男>> = 管家.查所有單身狗()
        .flowOn(Dispatchers.IO)  // 后臺線程保流暢
    
    fun 新增成員(昵稱: String, 年齡: Int) {
        viewModelScope.launch {
            管家.新增宅男(宅男(昵稱 = 昵稱, 年齡 = 年齡))
            // 自動生成ID美滋滋
        }
    }
}

//??

class OtakuViewModel(privateval otakuDao: OtakuDao) : ViewModel() {
    val singleOtakus: Flow<List<Otaku>> = otakuDao.getSingleOtakus()
        .flowOn(Dispatchers.IO)

    fun addOtaku(name: String, age: Int) {
        viewModelScope.launch {
            otakuDao.insert(
                Otaku(name = name, age = age, isSingle = true)
            )
        }
    }
}

坑爹預警（必看保命）

主線程禁忌

別在主線程搞數據庫！Room會直接給你甩臉崩潰。用協程、RxJava或者LiveData保平安。調試時可以開allowMainThreadQueries()，但上線前一定記得刪！

版本升級翻車現場

改表結構時記得升級version，建議用Migration類處理。實在懶可以用:

fallbackToDestructiveMigration()

但會刪數據！(別問我怎么知道的)

索引的玄學

高頻查詢字段加索引，但每個索引會讓寫入速度下降。主鍵自帶索引，不用重復加。

類型轉換騷操作

想存Date類型？用TypeConverter變身：

class TimestampConverter {
    @TypeConverter
    fun dateToTimestamp(date: Date?) = date?.time 
    
    @TypeConverter
    fun timestampToDate(timestamp: Long?) = timestamp?.let { Date(it) }
}

版本進化史

版本	系統	黑科技
2.2.x	4.1+	協程支持、預裝數據庫
2.5.x	4.1+	自動遷移、Upsert操作
2.6.x	4.1+	性能起飛、全文搜索

高階玩法（裝逼必備）

聯合作戰（Room+Hilt）

@Module
@InstallIn(RoomComponent::class)
object 數據庫裝備庫 {
    @Provides
    @Singleton
    fun 召喚數據庫(上下文: Context): 宅男宇宙 {
        return 宅男宇宙.啟動基地(上下文)
    }
    
    @Provides
    fun 召喚管家(數據庫: 宅男宇宙): 宅男管家 {
        return 數據庫.管家()
    }
}

// 在ViewModel里直接召喚
@HiltViewModel
class 高級管理局 @Inject constructor(
    privateval 管家: 宅男管家
) : ViewModel() {  }

//??

@Module
@InstallIn(RoomComponent::class)
object DatabaseModule {
    @Provides
    @Singleton
    fun provideDatabase(context: Context): OtakuDatabase {
        return OtakuDatabase.getDatabase(context)
    }

    @Provides
    fun provideDao(database: OtakuDatabase): OtakuDao {
        return database.otakuDao()
    }
}

@HiltViewModel
class OtakuViewModel @Inject constructor(privateval otakuDao: OtakuDao) : ViewModel() {
   
}

騷操作合集

@Transaction保證多個操作原子性
@RawQuery直接寫原生SQL（慎用！）
@Relation處理一對多關系
@Fts4搞全文搜索（2.6+專屬）

總結

Room這玩意兒就像樂高積木

?? Entity是基礎積木塊
?? DAO是組裝說明書
??? Database就是樂高城堡

記住：官方給的輪子使勁用就完事了，別總想著自己造輪子！遇到問題多查官方文檔，保你頭發茂密~

最后送大家一張Room護身符：

SELECT * FROM 頭發 WHERE 狀態 = '茂密';

責任編輯：武曉燕來源：沐雨花飛碟