Room概述

Room 是一個持久性庫，屬于 Android Jetpack 的一部分。

Room 是 SQLite 數據庫之上的一個抽象層。Room 并不直接使用 SQLite，而是負責簡化數據庫設置和配置以及與數據庫交互方面的瑣碎工作。此外，Room 還提供 SQLite 語句的編譯時檢查。

Room主要組件

Room 包含三個主要組件：

• 數據實體表示應用的數據庫中的表。數據實體用于更新表中的行所存儲的數據以及創(chuàng)建新行供插入。
• 數據訪問對象 (DAO) 提供應用在數據庫中檢索、更新、插入和刪除數據所用的方法。
• 數據庫類持有數據庫，并且是應用數據庫底層連接的主要訪問點。數據庫類為應用提供與該數據庫關聯的 DAO 的實例。

Room各組件之間協(xié)同工作圖例

添加Room庫

在build.gradle文件中添加依賴：

dependencies {
        //Room
        def room_version = "2.5.0"
        implementation "androidx.room:room-runtime:$room_version"
        annotationProcessor "androidx.room:room-compiler:$room_version"
}

版本號請查閱官方文檔：

https://developer.android.google.cn/jetpack/androidx/releases/room?hl=zh_cn#groovy

創(chuàng)建Item 實體—Entity

實體類定義了一個表，每個實例都是表的某一行。用映射的方式，實體類告知Room數據庫，它應如何呈現數據庫中的信息并與之交互。

@Entity 注解用于將某個類標記為數據庫實體類。對于每個實體類，系統(tǒng)都會創(chuàng)建一個數據庫表來保存相關項。存儲在數據庫中的每個實體實例必須有一個主鍵，用于唯一標識數據庫表中的每個記錄/條目。主鍵一旦賦值就不能修改，只要它還存在于數據庫中，它就表示相應的實體對象。

在類之前加上 @Entity 注解來標識數據庫的實體，編譯時，系統(tǒng)便會根據這個類的設定來創(chuàng)建數據庫。

@Entity()
public class Word{

}

如果Entity()的參數為空，系統(tǒng)在創(chuàng)建數據庫時，會把類名作為數據庫的表名，如果要自定義表名，可以直接在Entity()里輸入參數：

@Entity(tableName = "yourTableName")

接下來，我們應該添加：

• 數據庫的元素
• 主鍵：每一個實體至少定義一個字段作為主鍵?？梢詫PrimaryKey的autoGenerate屬性設置為true來設置自動id。如果實體有一個復合的主鍵，可以使用 @Entity的primaryKeys屬性來指定主鍵。

元素包括：

• id
• word
• chineseMearning

@PrimaryKey(autoGenerate = true)
private  int id;
@ColumnInfo(name = "english_word")
private String word;
@ColumnInfo(name = "chinese_mearning")
private String chineseMeaning;

再加上幾個get/set方法就定義完成了！

創(chuàng)建item 數據訪問對象—Dao

新建一個MyDao對象的接口作為數據庫操作的接口，在這個接口中，我們定義數據庫的增刪改查操作，在此之前，我們需要用 @Dao 來標記這個類為Dao類：

例如：

@Dao    //Database access object
public interface WordDao {
    @Insertvoid  
    insertWords(Word... words);
    
    @Updateint 
    updateWords(Word... words);
    
    @Deletevoid 
    deleteWords(Word...words);
}

如果我們要使用SQL語句，我們可以這么寫：

@Dao    //Database access object
public interface WordDao {
    @Insertvoid  
    insertWords(Word... words);
    
    @Updateint 
    updateWords(Word... words);
    
    @Deletevoid 
    deleteWords(Word...words);
    
    @Query("DELETE FROM WORD")
    void deleteWords();
    
    @Query("SELECT * FROM WORD ORDER BY ID DESC")
    List<Word> getAllWords();
}

創(chuàng)建數據庫實例—Database

我們將創(chuàng)建database類，通過繼承改寫room的database，把word.class和wordDao.class聯系在一起，組成一個完整的數據庫。

在同一個位置新建一個WordDatabase的數據庫，父類是androidx.room.RoomDatabase，為abstract類型。

我們通過@Database()來標記這個類為database類，在它的參數中我們可以定義:

• entities：傳入所有Entity的class對象；
• version：數據庫版本號。
• exportSchema：設置是否導出數據庫schema，默認為true，需要在build.gradle中設置：

當數據庫發(fā)生改變時，數據庫版本號會接著改變，以便更好的進行備份恢復，這里我們用不到，就隨便設計一個值。

上面的Database()中，我們已經把Entity連接到了database中，在Dao類中，我們需要把wordDao類連接到數據庫中，我們就需要實例化一個WordDao類：

@Database(entities = {Word.class},version = 1, exportSchema = false)
public abstract class WordDatabase extends RoomDatabase {
    public abstract WordDao getWordDao();
}

使用Room數據庫

獲取AppDatabase實例：

AppDatabase wordDatabase = Room.databaseBuilder(getApplicationContext(),AppDatabase.class, "user.db").build();

使用Room可以參考：

wordDao = wordDatabase.getWordDao();  // new a dao

List<Word> list = wordDao.getAllWords();  //get all data from database with sql: select * from word

結語

以上就是Android使用Room數據庫解決本地持久化的操作的詳細內容，更多關于Android Room本地持久化的資料請關注腳本之家其它相關文章！

最新評論