当前位置：首页 > news >正文

Android 数据持久化之数据库存储 Room 框架

news 2025/7/6 19:05:33

一、简介

Room 是 Google 推出的 Android 持久层框架，建立在 SQLite 之上，提供了一个抽象层，简化了数据库操作。它通过注解和编译时检查来确保数据操作的正确性。

Room 主要由以下三个组件组成：

Entity（实体）：定义封装实际数据的实体类，每个实体类对应数据库中的一个表，每个字段对应表中的一个列。
DAO（数据访问对象）：定义了用于操作数据库的方法，Room 会自动生成这些方法的实现。逻辑层无需和底层数据库打交道，直接和 Dao 层交互。
Database（数据库）：作为数据库的容器，提供对数据库的访问点。定义了数据库的关键信息（版本号、包含的实体类），并提供 Dao 层的访问实例。

二、使用方法

1、添加依赖库

在项目的 app/build.gradle 文件中添加 Room 的依赖。

	plugins {alias(libs.plugins.android.application)alias(libs.plugins.kotlin.android)alias(libs.plugins.kotlin.compose)// kotlin-kapt 插件kotlin("kapt")}......dependencies {......// Room 数据库implementation("androidx.room:room-runtime:2.7.1")kapt("androidx.room:room-compiler:2.7.1")implementation("androidx.room:room-ktx:2.7.1")}

2、定义 Entity

定义一个实体类，它将映射为数据库中的一个表。
若定义的字段有唯一性，可作为主键添加注解 @PrimaryKey，若所有字段没有唯一性，可另外添加 id 字段作为主键，并设置为自增长。

	@Entity(tableName = "users")data class UserEntity(val name: String,val gender: String,val age: Int) {@PrimaryKey(autoGenerate = true)val id: Long = 0}

3、定义 Dao

定义一个接口，声明对数据库的操作方法，有增、删、改、查 4 种方法，Room 提供了 @Insert、@Delete、@Update、@Query 4 种相应的注解。

	@Daointerface UserDao {@Insertfun insertUser(user: UserEntity)@Insertfun insertUsers(vararg users: UserEntity)@Deletefun deleteUser(user: UserEntity)@Updatefun updateUser(user: UserEntity)@Query("select * from users")fun getUsers(): List<UserEntity>@Query("select * from users where gender =:gender")fun getUsersByGender(gender: String)@Query("select * from users where age > :age")fun getUsersOlderThan(age: Int)@Query("delete from users where name = :name")fun deleteUserByName(name: String)}