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文件中，添加以下依靠：
  
  1. def room_version = "2.6.1"
  3. implementation "androidx.room:room-runtime:$room_version"
  4. // If this project uses any Kotlin source, use Kotlin Symbol Processing (KSP)
  5. // See KSP Quickstart to add KSP to your build
  6. ksp "androidx.room:room-compiler:$room_version"
  9. //如果需要，也可以引入以下依赖
  11. // If this project only uses Java source, use the Java annotationProcessor
  12. // No additional plugins are necessary
  13. annotationProcessor "androidx.room:room-compiler:$room_version"
  15. // optional - RxJava2 support for Room
  16. implementation "androidx.room:room-rxjava2:$room_version"
  18. // optional - RxJava3 support for Room
  19. implementation "androidx.room:room-rxjava3:$room_version"
  21. // optional - Guava support for Room, including Optional and ListenableFuture
  22. implementation "androidx.room:room-guava:$room_version"
  24. // optional - Test helpers
  25. testImplementation "androidx.room:room-testing:$room_version"
  27. // optional - Paging 3 Integration
  28. implementation "androidx.room:room-paging:$room_version"

  复制代码
• 创建实体类
  创建一个Kotlin类，表示数据库中的一个表。比方，如果要创建一个名为"User"的用户表，可以编写如下代码：
  
  1. @Entity(tableName = "users")
  2. data class User(
  3.      @PrimaryKey val id: Int,
  4.      val name: String,
  5.      val age: Int
  6. )

  复制代码
• 创建数据访问对象（DAO）
  创建一个接口，用于界说访问数据库的方法。比方，如果要访问"User"表，可以编写如下代码：
  
  1. @Dao
  2. interface UserDao {
  3.     @Insert
  4.     suspend fun insert(user: User)
  6.     @Query("SELECT * FROM users")
  7.     suspend fun getAllUsers(): List<User>
  9.     @Query("SELECT * FROM users WHERE id = :id")
  10.     suspend fun getUserById(id: Int): User
  11.    
  12.     @Query("SELECT * FROM users WHERE id IN (:ids)")
  13.     suspend fun getUserByIds(ids: List<Int>): List<User>
  15.     @Update
  16.     suspend fun updateUser(user: User)
  18.     @Delete
  19.     suspend fun deleteUser(user: User)
  20. }

  复制代码
• 创建数据库类
  创建一个抽象类，继续自RoomDatabase，并使用@Database注解进行标志。在类中界说一个抽象方法，返回之前创建的DAO接口的实例。比方，如果要创建名为"AppDatabase"的数据库，可以编写如下代码：
  
  1. @Database(entities = [User::class], version = 1)
  2. abstract class AppDatabase : RoomDatabase() {
  3.     abstract fun userDao(): UserDao
  4.    
  5.         companion object {
  6.        
  7.         @Volatile
  8.         private var INSTANCE: AppDatabase? = null
  9.         //单例
  10.         fun getDatabase(context: Context): AppDatabase {
  11.             return INSTANCE ?: synchronized(this) {
  12.                 val instance = Room.databaseBuilder(
  13.                     context.applicationContext,
  14.                     AppDatabase::class.java,
  15.                     "app_database")
  16.                     .build()
  17.                 INSTANCE = instance
  18.                 instance
  19.         }
  20.     }
  21. }

  复制代码
• 初始化数据库
  在应用程序的入口处，初始化数据库实例。比方，可以将以下代码放在Application类的onCreate()方法中：
  
  1. val database = AppDatabase.getDatabase(applicationContext)

  复制代码
• 使用数据库
  使用之前界说的DAO接口来执行数据库操作。
  
  1. // 插入用户
  2. val user = User(1, "John Doe", 25)
  3. database.userDao().insert(user)
  5. // 获取所有用户
  6. val users = database.userDao().getAllUsers()
  8. // 根据id获取用户
  9. val user = database.userDao().getUserById(1)
  11. //查询指定的多个ID
  12. val list = listOf(1,2,3)
  13. val users1 = database.userDao().getUserByIds(list)
  15. // 更新用户
  16. user.name = "Jane Doe"
  17. database.userDao().updateUser(user)
  19. // 删除用户
  20. 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

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。