前言：今天開始為大家打來Jetpack系列的學(xué)習(xí)，首先今天開始學(xué)習(xí)Jetpack中很重要的組件Room數(shù)據(jù)庫体捏。

如有興趣可了解下本人的Jetpack系列文章：

Jetpack系列1——Room 數(shù)據(jù)庫
Jetpack系列2——ViewBinding數(shù)據(jù)綁定

1. Room

Room是一個(gè)數(shù)據(jù)庫對象映射庫冠摄，可輕松訪問Android應(yīng)用程序上的數(shù)據(jù)庫糯崎。

1.1 Room介紹

• 介紹：Room是Jetpack組件庫一員，屬于ORM庫河泳，主要是對Sqlite做了一層抽象沃呢，從而簡化開發(fā)者對數(shù)據(jù)庫操作。Room支持編譯時(shí)的語法檢查拆挥，并且支持返回LiveData薄霜。簡單來說就是封裝了Sqlite方便使用。

1.1.1 Room中三個(gè)主要組件介紹

• Database纸兔、Entity惰瓜、DAO

下面是其三者和數(shù)據(jù)庫的關(guān)系圖：

image.png

1.1.2 Database 組件

• 此組件用于創(chuàng)建數(shù)據(jù)庫的持有者，同時(shí)在類層級上使用注解來定義一系列的Entity汉矿，這些Entity對應(yīng)著數(shù)據(jù)庫中的表格崎坊。
• Database類中的方法則用來獲取對應(yīng)的Dao列表。Database是App層與底層SQLite之間的連接點(diǎn)洲拇。在應(yīng)用中要使用此組件的話需要繼承RoomDatabase奈揍。然后通過Room.databaseBuilder()或者Room.inMemoryDatabaseBuilder().獲得該類的實(shí)例。

1.1.3 Entity 組件

• 此組件的一個(gè)實(shí)例表示數(shù)據(jù)庫的一行數(shù)據(jù)赋续，對于每個(gè)Entity類來說男翰，都會有對應(yīng)的table被創(chuàng)建。想要這些Entity被創(chuàng)建纽乱，就需要寫在上面Database的注解參數(shù)entities列表中蛾绎。默認(rèn)Entity中的所有字段都會拿來創(chuàng)建表，除非在該字段上加上@Ignore注解鸦列。

• 注意：Entity默認(rèn)都只有空的構(gòu)造方法（如果DAO類可以訪問每個(gè)持久化字段）租冠，或者構(gòu)造方法的參數(shù)與Entity中的字段的類型和名字相匹配。

Room可以使用全字段構(gòu)造方法敛熬，也可以使用部分字段構(gòu)造方法肺稀。

1.1.4 DAO 組件

• 這個(gè)組件用來表示具有Data Access Object(DAO)功能的類或接口。

• DAO類是Room的重要組件应民，負(fù)責(zé)定義訪問數(shù)據(jù)庫的方法话原。繼承RoomDatabase的類必須包含一個(gè)0參數(shù)且返回DAO類的方法。當(dāng)在編譯期生成代碼的時(shí)候诲锹，Room會創(chuàng)建實(shí)現(xiàn)此DAO的類繁仁。

• 注意：通過使用DAO類而不是傳統(tǒng)的查詢接口來訪問數(shù)據(jù)庫，可以做到數(shù)據(jù)庫組件的分離归园。同時(shí)DAO可以在測試APP時(shí)支持Mock數(shù)據(jù)黄虱。

1.2 使用方式

1.2.1 如何引用（以下均為Kotlin寫法）

• 導(dǎo)入依賴

def room_version = "2.2.5"
implementation "androidx.room:room-runtime:$room_version"
kapt "androidx.room:room-compiler:$room_version"

1.2.3 創(chuàng)建數(shù)據(jù)庫實(shí)體類 Entity

• 實(shí)體類中可能用到注解有：

• @Entity 將實(shí)體類定義為數(shù)據(jù)庫實(shí)類

• @Entity(tableName = "表名") 將數(shù)據(jù)庫名稱進(jìn)行修改

• @PrimaryKey(autoGenerate = true) 設(shè)置主鍵自增

• @ColumnInfo(name = "列名稱") 將列名稱進(jìn)行修改

• @Ignore 忽略字段

• 使用如下

image.png

1.2.4 創(chuàng)建Dao類

• @Dao 指定類為使用的Dao類

image.png

• @Insert 插入數(shù)據(jù)到數(shù)據(jù)庫中

image.png

• @Update 從數(shù)據(jù)庫中修改數(shù)據(jù)

image.png

• @Delete 從數(shù)據(jù)庫中刪除數(shù)據(jù)

image.png

• @Query("查詢數(shù)據(jù)SQL") 從查詢數(shù)據(jù)庫中數(shù)據(jù)

image.png

1.2.5 創(chuàng)建Database對象

• @Database(entities = [User::class], version = 1)
• 使用entities來映射相關(guān)的實(shí)體類，version來指明當(dāng)前數(shù)據(jù)庫的版本號庸诱。

image.png

• 這里使用了單例模式來返回Database捻浦，以防止新建過多的實(shí)例造成內(nèi)存的浪費(fèi)晤揣。
  image.png

以上為數(shù)據(jù)庫使用前所需要?jiǎng)?chuàng)建的所有工作了，接下來就可以進(jìn)行使用了~

1.2.6 在Activity中使用

image.png

生成的數(shù)據(jù)庫在data/data/packageName/databases 目錄中朱灿。

1.2.7 數(shù)據(jù)庫升級

第一步：修改數(shù)據(jù)庫類

image.png

第二步：在Database中將version值加一

image.png

第三步：通過addMigrations方法進(jìn)行升級

image.png

按照步驟實(shí)現(xiàn)后昧识，重新運(yùn)行程序即可。

image.png

PS：使用Room配合AndroidStudio自帶插件Database Inspector(數(shù)據(jù)庫查詢插件)有奇效盗扒！

查看數(shù)據(jù)

[圖片上傳失敗...(image-a6bede-1614061323362)]

查詢數(shù)據(jù)

image.png

修改數(shù)據(jù)

image.png

1.3 參考文章

• 官方介紹地址：https://developer.android.google.cn/jetpack/androidx/releases/room
• 知乎學(xué)習(xí)文章：https://zhuanlan.zhihu.com/p/94008969
• 簡書博客文章：http://www.reibang.com/p/82a06f579e52