一篇聊聊Jetpack Room實現數據存儲持久性

作者：Reathin 2023-12-08 08:26:05

Room 是 Android Jetpack 組件庫中的一部分，它是用于在 Android 應用中進行本地數據庫訪問和管理的庫。Room 提供了一個抽象層，使開發者能夠更輕松地訪問 SQLite 數據庫，并且可以在不直接使用 SQL 語句的情況下進行數據庫操作。

Room介紹

Room 主要包括三個主要組件：

Entity：用于定義數據庫中的表結構，每個實體類對應數據庫中的一張表。
DAO（Data Access Object）：用于定義數據庫操作的接口，開發者可以在 DAO 中定義各種數據庫操作方法，Room 會根據這些方法自動生成相應的 SQL 查詢語句。
Database：用于定義數據庫的抽象類，其中包括數據庫的版本號、實體類和 DAO 的引用，以及數據庫的創建和升級邏輯。

通過使用 Room，開發者可以更加方便地進行數據庫操作，同時也能夠避免直接操作 SQL 語句所帶來的風險。

Room使用

添加Room依賴：在你的Android項目中的build.gradle文件中添加Room依賴。

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

創建實體類：使用@Entity注解創建表示數據庫表的實體類，并使用@PrimaryKey注解指定主鍵。

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

創建DAO接口：使用@Dao注解創建數據訪問對象接口，定義數據庫操作方法。

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

    @Insert
    void insertUser(User user);

    @Delete
    void deleteUser(User user);
}

創建數據庫類：使用@Database注解創建數據庫類，并在其中定義數據庫版本號和實體類與DAO接口的關聯。

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

初始化數據庫：在應用程序中初始化數據庫實例。

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

Room升/降級

「Room升級」

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

「Room降級」

更新實體類：如果需要刪除字段或修改現有字段，需要更新實體類。
更新數據庫版本號：在RoomDatabase的子類中減小數據庫版本號，并且編寫數據庫降級的代碼。
編寫數據庫降級代碼：在RoomDatabase的子類中，通過fallbackToDestructiveMigration()方法或者編寫具體的數據庫降級邏輯來實現數據庫的降級。

在Android中使用Room進行數據庫升級和降級可以通過數據庫版本號來實現。

在進行數據庫升級時，只需修改數據庫版本號，并提供數據庫升級的回調函數：

@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) {
            // 在此處執行數據庫升級的操作
        }
    };
}

在進行數據庫降級時，需要提供數據庫降級的回調函數，并指定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) {
            // 在此處執行數據庫降級的操作
        }
    };
}

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

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

數據存儲持久性