在 Android 中预填充房间数据库

房间（Room）是 Google 推出的一个使用 SQLite 数据库的库，用于简化 Android 应用程序中的数据库操作。在某些情况下，我们需要在应用程序安装时预填充一些初始数据到数据库，本文将介绍如何在 Android 中预填充房间数据库。

第一步：创建预填充数据库的 SQLite 文件

首先，我们需要创建一个 SQLite 数据库文件，并向其中添加我们要预填充的数据。我们可以使用任何 SQLite 数据库管理工具来完成此操作。在本教程中，我们将使用 SQLiteStudio，但其他工具也同样适用。

首先，创建一个名为 mydatabase.db 的数据库文件，并创建一个名为 user 的表。表结构如下：

CREATE TABLE user (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    age INTEGER NOT NULL
);

然后，向此表中插入一些示例数据：

INSERT INTO user (name, age) VALUES ('Alice', 25);
INSERT INTO user (name, age) VALUES ('Bob', 30);
INSERT INTO user (name, age) VALUES ('Charlie', 35);

保存数据库文件并将其复制到 Android 应用程序的 assets 目录中。

第二步：创建房间数据库

接下来，我们需要在 Android 应用程序中创建一个房间数据库。这可以通过创建一个继承自 RoomDatabase 的抽象类来完成。我们称其为 AppDatabase。我们需要在 AppDatabase 中定义一个抽象方法，用于获取与 user 表相关联的 DAO。

@Database(entities = [User::class], version = 1)
abstract class AppDatabase : RoomDatabase() {
    abstract fun userDao(): UserDao
}

在上面的代码中，@Database 注释用于指定该数据库的实体和版本号。在该示例中，我们仅使用了一个实体，即 User，其对应于我们在 SQLite 文件中创建的 user 表。

接下来，我们需要创建一个 Kotlin 类来表示 user 表中的实体。我们称其为 User。

@Entity(tableName = "user")
data class User(
    @ColumnInfo(name = "id")
    @PrimaryKey(autoGenerate = true)
    val id: Long,
    val name: String,
    val age: Int
)

在上面的代码中，@Entity 注释用于指定表名。@ColumnInfo 注释用于指定数据库表列的名称。@PrimaryKey 注释用于指定表的主键。在这种情况下，我们使用 id 列作为主键，并启用自动增量。

接下来，我们创建一个 UserDao 接口，其中定义了一些操作 user 表的方法，如 getAll()、insert()、deleteAll() 等。

@Dao
interface UserDao {
    @Query("SELECT * FROM USER")
    fun getAll(): List<User>

    @Insert
    fun insert(user: User)

    @Query("DELETE FROM USER")
    fun deleteAll()
}

现在，我们已经成功定义了房间数据库以及 user 表的实体和 DAO。

第三步：预填充数据库

最后，我们需要在应用程序启动时，将数据从 SQLite 文件复制到我们刚创建的数据库中。

我们可以创建一个 Kotlin 单例类来完成此操作。我们称其为 DatabaseInitializer。

object DatabaseInitializer {
    fun preloadDatabase(context: Context) {
        val database = Room.databaseBuilder(context, AppDatabase::class.java, "mydatabase.db")
            .createFromAsset("mydatabase.db")
            .fallbackToDestructiveMigration()
            .build()

        database.userDao().getAll()
    }
}

在上面的代码中，我们使用 Room.databaseBuilder() 方法以及 createFromAsset() 方法来创建一个数据库实例。createFromAsset() 方法用于从 mydatabase.db 文件中加载数据。然后，我们无需执行任何查询操作，即可使其生成应用基础表。

我们还需要在应用程序启动时调用此方法。我们可以在应用程序的 Application 类中的 onCreate() 方法中调用此方法。

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        DatabaseInitializer.preloadDatabase(this)
    }
}

通过以上步骤，我们已经成功预填充了房间数据库。现在，我们可以在应用程序中使用 Room 库来查询这些数据。

结论

本文介绍了如何在 Android 应用程序中使用房间库来预填充初始数据。要完成此操作，我们需要创建一个 SQLite 文件，并在其中添加示例数据。我们还需要创建一个房间数据库以及一个与之关联的 DAO。最后，我们需要编写代码将数据从 SQLite 文件复制到数据库中，以及在应用程序启动时调用此代码。