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

【Android】Room数据库的使用

news 2025/9/6 6:52:43

在这里插入图片描述

三三要成为安卓糕手

引入

Room是一个抽象层，对SQLite进行了封装，简化了SQLite数据库的操作，让开发者能以更加对象化的方式进行数据库操作；Room解决了SQLite操作繁琐，容易产生错误的问题，让开发者能以更加对象化的方式进行数据库操作。

一：添加依赖

Room属于Jetpack中关于数据库操作的库，不属于安卓原生SDK开发包，所以需要单独添加依赖

// app/build.gradle
dependencies {//添加room运行时依赖库implementation "androidx.room:room-runtime:2.6.1"// Room 编译时注解处理器annotationProcessor "androidx.room:room-compiler:2.6.1"// 可选：RxJava2 支持 (如果需要使用RxJava2的异步机制配合Room使用，需要添加这个依赖)implementation "androidx.room:room-rxjava2:2.6.1"// 可选：RxJava3 支持 (如果需要)implementation "androidx.room:room-rxjava3:2.6.1"
}

二：Room 的核心组件

Room 数据库主要有三个核心组件：

  • Entity（实体类）：用于表示数据库表的数据结构。

  • DAO（Data Access Object）：用于定义数据库操作的方法。

  • Database（数据库类）：用于创建数据库实例，并将 Entity 和 DAO 关联起来

1：Entity层

定义与作用：Entity 代表数据库中的一张表，它是一个 Java 类，通过 @Entity 注解来标识。每个 Entity 类的实例对应表中的一行数据，类中的属性对应表中的列

@Entity(tableName = "user-room")
public class MyUser {@PrimaryKey(autoGenerate = true)private int id;@ColumnInfo(name = "user_age")private int age;@ColumnInfo(name = "user_name")private String name;@ColumnInfo(name = "user_email")private String email;public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public int getId() {return id;}public void setId(int id) {this.id = id;}public int getAge() {return age;}public void setAge(int age) {this.age = age;}public String getName() {return name;}public void setName(String name) {this.name = name;}
}

  • Entity [ˈentəti] 实体

    理解：把注解转化成编译器能够看懂的东西

  • tableName = "user-room" 指定了该实体类对应的数据库表名为 user - room。

  • @ColumnInfo(name = "user_age")当前的字段对应我们数据库中那一列的字段

  • @PrimaryKey(autoGenerate = true) 自增主键，设置为fasle的话就需要程序员自己设置id了

2：DAO层（数据访问对象）

定义与作用：Dao 接口定义了对数据库进行增删改查（CRUD，Create、Read、Update、Delete）操作的方法。它是应用代码与数据库之间交互的桥梁，通过定义不同的方法来执行具体的 SQL 语句或 Room 封装的操作

@Dao
public interface MyUserDao {@Insertvoid insertUser(MyUser user);/*** 通过MyUser类型直接更新数据库，Room会根据MyUser中的主键来查找对应的数据，并且更新* @param user*/@Updateint updateUser(MyUser user);/*** 更新user-room这个表中，名字是等于name(第一个参数)的数据，把这条数据的user_age更新为age(第二个参数)*/@Query("update `user-room` set user_age = :age where user_name = :name")int updateUser(String name , int age);/*** 通过name查询user-room表中的某个数据* @param name* @return*/@Query("select * from `user-room` where user_name = :name")List<MyUser> getUserByName(String name);@Deleteint delUser(MyUser user);/*** 通过name删除对应的用户* @param name* @return*/@Query("delete from `user-room` where user_name = :name ")int delete(String name);
}
  • 这里设置的插入方法没有返回值；有返回值的情况：当插入单个实体对象时，返回值是一个 long 类型，表示插入数据后自动生成的主键值（前提是自增主键）

3：Database层

它是一个抽象类，通过 @Database 注解来标识，通常会包含一个或者多个抽象方法），用于返回定义好的 Dao 接口实例，Room 会在运行时自动生成该抽象类的实现；（可以简单理解成一个方法对应找库中的一个表table）

@Database(entities = {MyUser.class} , version = 1)
public abstract class MyUserDatabase extends RoomDatabase {public abstract MyUserDao userDao();static final Migration MIGRATION_1_2 = new Migration(1,2) {@Overridepublic void migrate(@NonNull SupportSQLiteDatabase supportSQLiteDatabase) {supportSQLiteDatabase.execSQL("alter table `user-room` add column user_email text");}};
}
  • entities = {MyUser.class}关联一张表的名字，可以关联多张table，在花括号中填写即可；前提这张表一定是被entity标注过的

（1）版本迁移

如果要实现从版本 1 迁移到版本 5，不能直接写 Migration(1, 5) 来 “一步到位” 完成所有中间版本（1→2→3→4→5）的迁移。Room 要求必须为每一个相邻的版本跨度都定义对应的 Migration，也就是需要分别定义：

  • 从版本 1 到版本 2 的 Migration；
  • 从版本 2 到版本 3 的 Migration；
  • 从版本 3 到版本 4 的 Migration；
  • 从版本 4 到版本 5 的 Migration。

然后在构建数据库时，通过 addMigrations() 方法把这些所有相邻版本的 Migration 都添加进去，Room 会在数据库升级时，按顺序执行这些 Migration，逐步完成从版本 1 到版本 5 的迁移。

（2）addMigration

        MyUserDatabase userDatabase = Room.databaseBuilder(ContentProviderActivity.this, MyUserDatabase.class, "user-database.db").addMigrations(MyUserDatabase.MIGRATION_1_2).build();

（3）数据库升级的时机

前提：创建数据库时add了对应的版本升级方法，这个迁移方法内部的具体规则需要再Database层中进行声明

如果当前版本为1，由于要给表添加新的列或者修改某个字段等等，想要升级到版本2；

那么这里就要修改为2@Database(entities = {MyUser.class} , version = 2)，再次运行代码的时候，MyUserDatabase.MIGRATION_1_2 这个迁移规则，它会告诉 Room 如何将版本 1 的数据库转换为版本 2 的数据库，这样在数据库版本升级时，就能按照这个规则来执行相应的操作

    static final Migration MIGRATION_1_2 = new Migration(1,2) {@Overridepublic void migrate(@NonNull SupportSQLiteDatabase supportSQLiteDatabase) {supportSQLiteDatabase.execSQL("alter table `user-room` add column user_email text");}};

migration 信息迁移 alter 修改

效果如下，我们在Entity层中新增加的字段user_email成功添加进来了，现在就是版本2

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

4：创建数据库

        MyUserDatabase userDatabase = Room.databaseBuilder(ContentProviderActivity.this, MyUserDatabase.class, "user-database.db").addMigrations(MyUserDatabase.MIGRATION_1_2).build();
  • 参数一：上下文
  • 参数二：数据库的class对象
  • 参数三：表示要创建的 SQLite 数据库文件的名称。

三：增删查改

1：增

    @Insertvoid insertUser(MyUser user);

        /*** 插入数据*/findViewById(R.id.btn_insert).setOnClickListener(view -> {new Thread(new Runnable() {@Overridepublic void run() {//可以理解成操作table表的对象MyUserDao myUserDao = userDatabase.userDao();MyUser user = new MyUser();user.setName(etUserName.getText().toString().trim());user.setAge(Integer.valueOf(etUserAge.getText().toString().trim()));myUserDao.insertUser(user);userDatabase.close();}}).start();});

数据库操作是一个非常耗时的操作，如果是在主线程操作会引起卡顿和崩溃，Room中插入数据需要指定在非主线程中进行，使用SQLite不用指定新线程，因为它内部已经帮我们处理好了外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

（1）插入结果

Room数据库会把我们的插入或者查询操作进行分段读写，所以就有三个文件，没有db后缀，Room也会自动帮我们转化为db文件的

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

为了测试，我们手动去添加后缀；并且想要整合三个文件，就需要手动close一次数据库操作

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

效果如下

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

2：查 & 改

（1）修改数据

    /*** 通过MyUser类型直接更新数据库，Room会根据MyUser中的主键来查找对应的数据，并且更新* @param user*/@Updateint updateUser(MyUser user);

        /*** 更新数据*/findViewById(R.id.btn_update).setOnClickListener(view -> {new Thread(new Runnable() {@Overridepublic void run() {MyUserDao myUserDao = userDatabase.userDao();MyUser user = new MyUser();user.setId(1);user.setName(etUserName.getText().toString().trim());user.setAge(Integer.valueOf(etUserAge.getText().toString().trim()));myUserDao.updateUser(user);//通过名字查询到对应的信息，修改这个用户的年龄userDatabase.userDao().updateUser("lisi",100);}}).start();});

（2）根据主键查找

    /*** 通过name查询user-room表中的某个数据* @param name* @return*/@Query("select * from `user-room` where user_name = :name")List<MyUser> getUserByName(String name);

        /*** 查询数据*/findViewById(R.id.btn_select).setOnClickListener(view -> {new Thread(new Runnable() {@Overridepublic void run() {MyUserDao myUserDao = userDatabase.userDao();String queryName = etUserName.getText().toString().trim();List<MyUser> users = myUserDao.getUserByName(queryName);Log.i(TAG, "run：users.size" + users.size());if(users.size() > 0){runOnUiThread(new Runnable() {@Overridepublic void run() {//显示查询到的用户数据MyUser user = users.get(0);tvMessage.setText(tvMessage.getText() +"\n" + user.getName() + ":" + user.getAge());}});}}}).start();});

效果如下

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

（3）根据字段查找

通过别的数据进行user的查找；不想通过User实体类和主键，进行查找

自定义查询规则，sql语句

    /*** 更新user-room这个表中，名字是等于name(第一个参数)的数据，把这条数据的user_age更新为age(第二个参数)*/@Query("update `user-room` set user_age = :age where user_name = :name")int updateUser(String name , int age);

3：删

多尝试

    @Deleteint delUser(MyUser user);

    /*** 通过name删除对应的用户* @param name* @return*/@Query("delete from `user-room` where user_name = :name ")int delete(String name);

        findViewById(R.id.btn_delete).setOnClickListener(view -> {new Thread(new Runnable() {@Overridepublic void run() {
//                    MyUser user = new MyUser();
//                    user.setId(1);
//                    userDatabase.userDao().delUser(user);userDatabase.userDao().delete("wangwu");}}).start();});

文章转载自：

http://KkHFxoXi.tczLz.cn
http://l1KuLePL.tczLz.cn
http://TVTGMC56.tczLz.cn
http://zVZ27Q3q.tczLz.cn
http://zjsBOLAj.tczLz.cn
http://ccmeA6fC.tczLz.cn
http://BLB1EUan.tczLz.cn
http://LkgESPS2.tczLz.cn
http://z0XwX4vI.tczLz.cn
http://5zFAZTrw.tczLz.cn
http://272kF4iR.tczLz.cn
http://Dlplp7jf.tczLz.cn
http://wkRC3B2A.tczLz.cn
http://PfUIIl45.tczLz.cn
http://9ygf00XC.tczLz.cn
http://3H9mBPEL.tczLz.cn
http://otCc2L4Z.tczLz.cn
http://Iqk3That.tczLz.cn
http://qXNDew2r.tczLz.cn
http://NxY4wFnG.tczLz.cn
http://0Cw3zFWW.tczLz.cn
http://ZMQYchjl.tczLz.cn
http://XO2yyBxH.tczLz.cn
http://ajHKJyxS.tczLz.cn
http://h4VyyDUY.tczLz.cn
http://CJueNLmi.tczLz.cn
http://toXdjPwX.tczLz.cn
http://7VqLZxOV.tczLz.cn
http://XrrxRtPw.tczLz.cn
http://siphYk06.tczLz.cn
http://www.dtcms.com/a/368410.html

相关文章：

  • CoolGuard风控系统配置评分卡、权重策略｜QLExpress脚本
  • 【FastDDS】Layer Transport ( 02-Transport API ）
  • 确保 SQL Server 备份安全有效的最佳实践
  • 盘点完今年CoRL最火的VLA论文，发现最强的机器人，竟是用“假数据”喂大的
  • 新闻丨重庆两江新区党工委副书记、管委会主任许宏球一行莅临华院计算考察指导
  • 基于YOLO目标检测模型的视频推理GUI工具
  • latex公式符号与字体
  • SQL Server事务隔离级别
  • SQL高效处理海量GPS轨迹数据：人员gps轨迹数据抽稀实战指南
  • 查询语言的进化：SQL之后，为什么是GQL？数据世界正在改变
  • 概念 | C标准库STL，C运行时库CRT
  • JAiRouter 配置文件重构纪实 ——基于单一职责原则的模块化拆分与内聚性提升
  • ZooKeeper架构深度解析：分布式协调服务的核心设计与实现
  • ResNet 迁移学习---加速深度学习模型训练
  • Django REST framework：SimpleRouter 使用指南
  • Vue3 频率范围输入失焦自动校验实现
  • 删除元素(不是删除而是覆盖)快慢指针 慢指针是覆盖位置，快指针找元素
  • 代码随想录算法训练营第三天| 链表理论基础 203.移除链表元素 707.设计链表 206.反转链表
  • 结合机器学习的Backtrader跨市场交易策略研究
  • 前端开发vscode插件 - live server
  • 码农的“必修课”：深度解析Rust的所有权系统（与C++内存模型对比）
  • 【Python基础】 17 Rust 与 Python 运算符对比学习笔记
  • 云手机可以息屏挂手游吗？
  • 会话管理巅峰对决：Spring Web中Cookie-Session、JWT、Spring Session + Redis深度秘籍
  • 腾讯云大模型训练平台
  • iPhone17全系优缺点分析，加持远程控制让你的手机更好用！
  • 数据泄露危机逼近：五款电脑加密软件为企业筑起安全防线
  • 阿里云vs腾讯云按量付费服务器
  • DocuAI深度测评：自动文档生成工具如何高效产出规范API文档与数据库表结构文档？
  • React JSX 语法讲解