Android Room 持久化库的介绍及使用方法
Android Room 是 Android Jetpack 组件之一，是 Google 官方推出的用于简化 SQLite 数据库操作的持久化库。它提供了一个抽象层，允许开发者在 SQLite 数据库上执行常见的 CRUD 操作，同时处理数据库连接、数据迁移和查询优化等底层细节。
Android Room 的主要优点包括：
- 简化的API：Room 提供了简洁的注解和查询语言，使得数据库操作更加直观和易于编写。
- 编译时检查：Room 在编译时对 SQL 语句进行检查，可以提前发现错误，避免在运行时出现问题。
- 数据库迁移：Room 支持数据库结构的升级和迁移，可以轻松地处理应用程序版本更新时的数据迁移问题。
- 响应式编程：Room 结合 LiveData 或 RxJava，可以实现数据库查询的响应式编程，实时更新 UI。
使用 Android Room 的基本步骤包括：
- 定义实体类：使用注解在 Java 或 Kotlin 类中定义数据库表和字段。
- 创建数据访问对象（DAO）：定义用于执行数据库操作的接口或抽象类，并使用注解指定对应的 SQL 查询语句。
- 创建数据库：使用注解和数据库配置类来创建数据库，并指定相关的实体类和版本号。
- 执行数据库操作：通过调用 DAO 中定义的方法，即可对数据库进行增删改查操作。
Android Room 提供了一个简单而强大的方式来进行数据库操作，是开发 Android 应用程序时的首选选择之一。它的设计理念是为了提供更好的性能、更高的可靠性和更简单的开发体验。
下面是Android Room的基本使用方法。
-
添加Room依赖
在项目的build.gradle文件中，添加以下依赖：def room_version = "2.6.1" implementation "androidx.room:room-runtime:$room_version" // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP) // See KSP Quickstart to add KSP to your build ksp "androidx.room:room-compiler:$room_version" //如果需要，也可以引入以下依赖 // If this project only uses Java source, use the Java annotationProcessor // No additional plugins are necessary annotationProcessor "androidx.room:room-compiler:$room_version" // optional - RxJava2 support for Room implementation "androidx.room:room-rxjava2:$room_version" // optional - RxJava3 support for Room implementation "androidx.room:room-rxjava3:$room_version" // optional - Guava support for Room, including Optional and ListenableFuture implementation "androidx.room:room-guava:$room_version" // optional - Test helpers testImplementation "androidx.room:room-testing:$room_version" // optional - Paging 3 Integration implementation "androidx.room:room-paging:$room_version" -
创建实体类
创建一个Kotlin类，表示数据库中的一个表。例如，如果要创建一个名为"User"的用户表，可以编写如下代码：@Entity(tableName = "users") data class User( @PrimaryKey val id: Int, val name: String, val age: Int ) -
创建数据访问对象（DAO）
创建一个接口，用于定义访问数据库的方法。例如，如果要访问"User"表，可以编写如下代码：@Dao interface UserDao { @Insert suspend fun insert(user: User) @Query("SELECT * FROM users") suspend fun getAllUsers(): List<User> @Query("SELECT * FROM users WHERE id = :id") suspend fun getUserById(id: Int): User @Query("SELECT * FROM users WHERE id IN (:ids)") suspend fun getUserByIds(ids: List<Int>): List<User> @Update suspend fun updateUser(user: User) @Delete suspend fun deleteUser(user: User) } -
创建数据库类
创建一个抽象类，继承自RoomDatabase，并使用@Database注解进行标记。在类中定义一个抽象方法，返回之前创建的DAO接口的实例。例如，如果要创建名为"AppDatabase"的数据库，可以编写如下代码：@Database(entities = [User::class], version = 1) abstract class AppDatabase : RoomDatabase() { abstract fun userDao(): UserDao companion object { @Volatile private var INSTANCE: AppDatabase? = null //单例 fun getDatabase(context: Context): AppDatabase { return INSTANCE ?: synchronized(this) { val instance = Room.databaseBuilder( context.applicationContext, AppDatabase::class.java, "app_database") .build() INSTANCE = instance instance } } } -
初始化数据库
在应用程序的入口处，初始化数据库实例。例如，可以将以下代码放在Application类的onCreate()方法中：val database = AppDatabase.getDatabase(applicationContext) -
使用数据库
使用之前定义的DAO接口来执行数据库操作。// 插入用户 val user = User(1, "John Doe", 25) database.userDao().insert(user) // 获取所有用户 val users = database.userDao().getAllUsers() // 根据id获取用户 val user = database.userDao().getUserById(1) //查询指定的多个ID val list = listOf(1,2,3) val users1 = database.userDao().getUserByIds(list) // 更新用户 user.name = "Jane Doe" database.userDao().updateUser(user) // 删除用户 database.userDao().deleteUser(user)
官方链接：https://android-dot-google-developers.gonglchuangl.net/jetpack/androidx/releases/room
Room 和 Flow 简介及应用：https://developer.android.google.cn/codelabs/basic-android-kotlin-training-intro-room-flow
原文地址：https://blog.csdn.net/bailichun19901111/article/details/145130606
免责声明：本站文章内容转载自网络资源，如侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！