Room介紹
Room 是 Android Jetpack 組件庫中的一部分，它是用于在 Android 應用中進行本地數(shù)據(jù)庫訪問和管理的庫。Room 提供了一個抽象層，使開發(fā)者能夠更輕松地訪問 SQLite 數(shù)據(jù)庫，并且可以在不直接使用 SQL 語句的情況下進行數(shù)據(jù)庫操作。
Room 主要包括三個主要組件：
-
Entity：用于定義數(shù)據(jù)庫中的表結(jié)構(gòu)，每個實體類對應數(shù)據(jù)庫中的一張表。 -
DAO（Data Access Object）：用于定義數(shù)據(jù)庫操作的接口，開發(fā)者可以在 DAO 中定義各種數(shù)據(jù)庫操作方法，Room 會根據(jù)這些方法自動生成相應的 SQL 查詢語句。 -
Database：用于定義數(shù)據(jù)庫的抽象類，其中包括數(shù)據(jù)庫的版本號、實體類和 DAO 的引用，以及數(shù)據(jù)庫的創(chuàng)建和升級邏輯。
通過使用 Room，開發(fā)者可以更加方便地進行數(shù)據(jù)庫操作，同時也能夠避免直接操作 SQL 語句所帶來的風險。
Room使用
-
添加Room依賴：在你的Android項目中的build.gradle文件中添加Room依賴。
implementation "androidx.room:room-runtime:2.3.0"
annotationProcessor "androidx.room:room-compiler:2.3.0"
-
創(chuàng)建實體類：使用 @Entity注解創(chuàng)建表示數(shù)據(jù)庫表的實體類，并使用@PrimaryKey注解指定主鍵。
@Entity
public class User {
@PrimaryKey
public int id;
public String name;
public int age;
}
-
創(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);
}
-
創(chuàng)建數(shù)據(jù)庫類：使用 @Database注解創(chuàng)建數(shù)據(jù)庫類，并在其中定義數(shù)據(jù)庫版本號和實體類與DAO接口的關聯(lián)。
@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
public abstract UserDao userDao();
}
-
初始化數(shù)據(jù)庫：在應用程序中初始化數(shù)據(jù)庫實例。
AppDatabase db = Room.databaseBuilder(getApplicationContext(), AppDatabase.class, "database-name").build();
//查詢所有用戶信息
db.userDao().getllUsers();
Room升/降級
「Room升級」
-
更新實體類：如果需要添加新的字段或修改現(xiàn)有字段，需要更新實體類。 -
更新數(shù)據(jù)庫版本號：在RoomDatabase的子類中增加數(shù)據(jù)庫版本號，并且編寫數(shù)據(jù)庫升級的代碼。 -
編寫數(shù)據(jù)庫升級代碼：在RoomDatabase的子類中，通過 fallbackToDestructiveMigration()方法或者編寫具體的數(shù)據(jù)庫升級邏輯來實現(xiàn)數(shù)據(jù)庫的升級。
「Room降級」
-
更新實體類：如果需要刪除字段或修改現(xiàn)有字段，需要更新實體類。 -
更新數(shù)據(jù)庫版本號：在RoomDatabase的子類中減小數(shù)據(jù)庫版本號，并且編寫數(shù)據(jù)庫降級的代碼。 -
編寫數(shù)據(jù)庫降級代碼：在RoomDatabase的子類中，通過 fallbackToDestructiveMigration()方法或者編寫具體的數(shù)據(jù)庫降級邏輯來實現(xiàn)數(shù)據(jù)庫的降級。
在Android中使用Room進行數(shù)據(jù)庫升級和降級可以通過數(shù)據(jù)庫版本號來實現(xiàn)。
在進行數(shù)據(jù)庫升級時，只需修改數(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ù)庫升級的操作
}
};
}
在進行數(shù)據(jù)庫降級時，需要提供數(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ù)庫降級的操作
}
};
}
在進行升級和降級操作時，需要注意數(shù)據(jù)遷移的問題，確保數(shù)據(jù)能夠正確地從舊版本遷移到新版本或者從新版本遷移到舊版本。
