Room介紹

Room 是 Android Jetpack 組件庫中的一部分，它是用于在 Android 應(yīng)用中進(jìn)行本地?cái)?shù)據(jù)庫訪問和管理的庫。Room 提供了一個(gè)抽象層，使開發(fā)者能夠更輕松地訪問 SQLite 數(shù)據(jù)庫，并且可以在不直接使用 SQL 語句的情況下進(jìn)行數(shù)據(jù)庫操作。

Room 主要包括三個(gè)主要組件：

1. Entity：用于定義數(shù)據(jù)庫中的表結(jié)構(gòu)，每個(gè)實(shí)體類對應(yīng)數(shù)據(jù)庫中的一張表。
2. DAO（Data Access Object）：用于定義數(shù)據(jù)庫操作的接口，開發(fā)者可以在 DAO 中定義各種數(shù)據(jù)庫操作方法，Room 會(huì)根據(jù)這些方法自動(dòng)生成相應(yīng)的 SQL 查詢語句。
3. Database：用于定義數(shù)據(jù)庫的抽象類，其中包括數(shù)據(jù)庫的版本號、實(shí)體類和 DAO 的引用，以及數(shù)據(jù)庫的創(chuàng)建和升級邏輯。

通過使用 Room，開發(fā)者可以更加方便地進(jìn)行數(shù)據(jù)庫操作，同時(shí)也能夠避免直接操作 SQL 語句所帶來的風(fēng)險(xiǎn)。

Room使用

1. 添加Room依賴：在你的Android項(xiàng)目中的build.gradle文件中添加Room依賴。

implementation "androidx.room:room-runtime:2.3.0"
annotationProcessor "androidx.room:room-compiler:2.3.0"

2. 創(chuàng)建實(shí)體類：使用@Entity注解創(chuàng)建表示數(shù)據(jù)庫表的實(shí)體類，并使用@PrimaryKey注解指定主鍵。

@Entity
public class User {
    @PrimaryKey
    public int id;
    public String name;
    public int age;
}

3. 創(chuàng)建DAO接口：使用@Dao注解創(chuàng)建數(shù)據(jù)訪問對象接口，定義數(shù)據(jù)庫操作方法。

@Dao
public interface UserDao {
    @Query("SELECT * FROM user")
    List<User> getAllUsers();

    @Insert
    void insertUser(User user);

    @Delete
    void deleteUser(User user);
}

4. 創(chuàng)建數(shù)據(jù)庫類：使用@Database注解創(chuàng)建數(shù)據(jù)庫類，并在其中定義數(shù)據(jù)庫版本號和實(shí)體類與DAO接口的關(guān)聯(lián)。

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();
}

5. 初始化數(shù)據(jù)庫：在應(yīng)用程序中初始化數(shù)據(jù)庫實(shí)例。

AppDatabase db = Room.databaseBuilder(getApplicationContext(), AppDatabase.class, "database-name").build();
//查詢所有用戶信息
db.userDao().getllUsers();

Room升/降級

「Room升級」

1. 更新實(shí)體類：如果需要添加新的字段或修改現(xiàn)有字段，需要更新實(shí)體類。
2. 更新數(shù)據(jù)庫版本號：在RoomDatabase的子類中增加數(shù)據(jù)庫版本號，并且編寫數(shù)據(jù)庫升級的代碼。
3. 編寫數(shù)據(jù)庫升級代碼：在RoomDatabase的子類中，通過fallbackToDestructiveMigration()方法或者編寫具體的數(shù)據(jù)庫升級邏輯來實(shí)現(xiàn)數(shù)據(jù)庫的升級。

「Room降級」

1. 更新實(shí)體類：如果需要?jiǎng)h除字段或修改現(xiàn)有字段，需要更新實(shí)體類。
2. 更新數(shù)據(jù)庫版本號：在RoomDatabase的子類中減小數(shù)據(jù)庫版本號，并且編寫數(shù)據(jù)庫降級的代碼。
3. 編寫數(shù)據(jù)庫降級代碼：在RoomDatabase的子類中，通過fallbackToDestructiveMigration()方法或者編寫具體的數(shù)據(jù)庫降級邏輯來實(shí)現(xiàn)數(shù)據(jù)庫的降級。

在Android中使用Room進(jìn)行數(shù)據(jù)庫升級和降級可以通過數(shù)據(jù)庫版本號來實(shí)現(xiàn)。

在進(jìn)行數(shù)據(jù)庫升級時(shí)，只需修改數(shù)據(jù)庫版本號，并提供數(shù)據(jù)庫升級的回調(diào)函數(shù)：

@Database(entities = {User.class}, version = 2)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();

    static final Migration MIGRATION_1_2 = new Migration(1, 2) {
        @Override
        public void migrate(SupportSQLiteDatabase database) {
            // 在此處執(zhí)行數(shù)據(jù)庫升級的操作
        }
    };
}

在進(jìn)行數(shù)據(jù)庫降級時(shí)，需要提供數(shù)據(jù)庫降級的回調(diào)函數(shù)，并指定fallbackToDestructiveMigration為true：

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();

    static final Migration MIGRATION_2_1 = new Migration(2, 1) {
        @Override
        public void migrate(SupportSQLiteDatabase database) {
            // 在此處執(zhí)行數(shù)據(jù)庫降級的操作
        }
    };
}

在進(jìn)行升級和降級操作時(shí)，需要注意數(shù)據(jù)遷移的問題，確保數(shù)據(jù)能夠正確地從舊版本遷移到新版本或者從新版本遷移到舊版本。