手把手教你玩轉Room：Android數據庫的保命指南
作者：Reathin
聽說你要搞Android本地數據庫？別慌！Room這貨就是官方給的救命稻草，不用再被原生SQLite虐到脫發了。今天咱們用簡單的方式，掰開揉碎了講講這玩意兒怎么玩，保你半小時上手！
聽說你要搞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 狀態 = '茂密';責任編輯：武曉燕
來源：
沐雨花飛碟
