安卓中Room持久化库的使用

在这里插入图片描述
在Android开发中，Room是Google提供的一个持久化库，旨在为应用提供SQLite的抽象层，以简化数据库的访问和操作。相比直接使用SQLite，Room提供更清晰、更简洁的数据库访问机制。

1. Room的基础知识

1.1 引入Room依赖

首先，在你的项目的build.gradle (Module: app) 文件中添加Room的依赖：

dependencies {def room_version = "2.4.3"implementation "androidx.room:room-runtime:$room_version"annotationProcessor "androidx.room:room-compiler:$room_version"// 可选 - RxJava支持implementation "androidx.room:room-rxjava3:$room_version"// 可选 - Guava支持 (使用ImmutableList等)implementation "androidx.room:room-guava:$room_version"// Test helperstestImplementation "androidx.room:room-testing:$room_version"
}

确保替换room_version为最新的版本。

1.2 创建数据库实体

在Room中，每个数据库表由一个实体类表示。以下是一个示例实体类：

@Entity(tableName = "users")
public class User {@PrimaryKey(autoGenerate = true)private int id;@ColumnInfo(name = "first_name")private String firstName;@ColumnInfo(name = "last_name")private String lastName;// 构造函数、getter和setter省略
}

1.3 定义DAO（Data Access Object）

DAO是一个接口，定义了访问数据库的各种方法。Room将DAO的声明转换为实际的数据库代码。

@Dao
public interface UserDao {@Insertvoid insert(User user);@Query("SELECT * FROM users")List<User> getAllUsers();@Deletevoid delete(User user);@Updatevoid update(User user);
}

1.4 创建数据库类

Room数据库类是访问数据库的主要入口点。使用@Database注释来标记它，并列出所有的实体和版本号。

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

2. 使用Room数据库

2.1 获取数据库实例

通常你会使用单例模式来创建和管理数据库实例，避免频繁开销大的资源消耗。

public class DatabaseClient {private Context mCtx;private static DatabaseClient mInstance;// 我们的app数据库对象private AppDatabase appDatabase;private DatabaseClient(Context mCtx) {this.mCtx = mCtx;//创建数据库appdatabaseappDatabase = Room.databaseBuilder(mCtx, AppDatabase.class, "MyToDos").build();}public static synchronized DatabaseClient getInstance(Context mCtx) {if (mInstance == null) {mInstance = new DatabaseClient(mCtx);}return mInstance;}public AppDatabase getAppDatabase() {return appDatabase;}
}

2.2 执行数据库操作

使用DAO执行数据库操作。所有的数据库操作默认不在主线程执行。

// 插入
DatabaseClient.getInstance(getApplicationContext()).getAppDatabase().userDao().insert(new User(0, "John", "Doe"));// 获取用户
List<User> users = DatabaseClient.getInstance(getApplicationContext()).getAppDatabase().userDao().getAllUsers();

3. 进阶用法

3.1 复杂查询与LiveData

Room支持返回LiveData或Flowable对象，使得数据库的响应可以观察并自动更新UI。

@Query("SELECT * FROM users")
LiveData<List<User>> getLiveUsers();

3.2 数据库迁移

随着应用的发展，您可能需要修改数据库架构。Room可以通过数据库迁移脚本来处理架构变化：

Room.databaseBuilder(getApplicationContext(), AppDatabase.class, "database-name").addMigrations(MIGRATION_1_2, MIGRATION_2_3).build();

3.3 Type Converters

如果你需要存储自定义数据类型，那么Type Converters是必需的。

public class Converters {@TypeConverterpublic static Date fromTimestamp(Long value) {return value == null ? null : new Date(value);}@TypeConverterpublic static Long dateToTimestamp(Date date) {return date == null ? null : date.getTime();}
}

将Converter类添加到数据库定义中：

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