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 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) {
// 在此处执行数据库降级的操作
}
};
}
在进行升级和降级操作时,需要注意数据迁移的问题,确保数据能够正确地从旧版本迁移到新版本或者从新版本迁移到旧版本。