Android—Room数据库(介绍)

前言

Google终于发布了一个和SQLite相关的库了???。之前一直都是在SQLite、XUtils、greenDao、Realm这些数据库之间来回折腾。现在终于有一个更“正统”数据库了。

Room是什么?

Room是一个持久性数据库。

Room持久性库提供了SQLite的抽象层,以便在充分利用SQLite的同时允许流畅的数据库访问。

为什么会选择Room?

前面我也说到了现在也有不少开源的数据库给大家使用,那为什么我们还要去学习使用这个库呢?当然不是我前面说的“正不正统”的原因了。 因为Room有下面几个优点: ① SQL查询在编译时就会验证 - 在编译时检查每个@Query和@Entity等,这就意味着没有任何运行时错误的风险可能会导致应用程序崩溃(并且它不仅检查语法问题,还会检查是否有该表) ② 较少的模板代码 ③ 与 LiveData集成

该如何使用它?

1、在app/build.gradle中添加以下依赖

implementation 'android.arch.persistence.room:runtime:1.0.0'
annotationProcessor 'android.arch.persistence.room:compiler:1.0.0'

你可以点击这里查看最新依赖版本号

2、创建JavaBean

@Entity
public class User {
    
    @PrimaryKey(autoGenerate = true)//主键是否自动增长,默认为false
    private int id;
    private String name;
    private int age;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
   //这里的getter/setter方法是必须的
   //这里的getter/setter方法是必须的
   //这里的getter/setter方法是必须的
   //重要的事说三遍
}
  • 这里需要使用@Entity来注解该类
  • 至少要有一个主键@PrimaryKey

3、创建Dao 接下来,需要为我们的实体创建DAO。 DAO代表数据访问对象,所以它是告诉我们的数据库如何操作数据的一种方式:

@Dao
public interface UserDao {
    @Query("SELECT * FROM user")
    List<User> getAllUsers();

    @Insert
    void insert(User... users);

    @Update
    void update(User... users);

    @Delete
    void delete(User... users);
}
  • 使用@Dao注解该接口
  • @Insert, @Update, @Delete,@Query代表我们常用的插入更新删除查询数据库操作

@Insert, @Update, @Delete可以传入多种不同的参数。例如:

@Insert
void insert(User... users);

@Insert
void insert(User user);

@Insert
void insert(List<User> userLists);

同理,@Query也可以返回多种不同的类型。

@Query("SELECT * FROM user")
List<User> getAllUsers();

@Query("SELECT * FROM user WHERE id=:id")
User getUser(int id);

@Query("SELECT * FROM user")
Cursor getUserCursor();

当然,除了这些我们还可以传入一些限制符进去。例如,

@Query("SELECT * FROM user WHERE age=:age")
List<User> getUsersByAge(int age);

@Query("SELECT * FROM user WHERE age=:age LIMIT :max")
List<User> getUsersByAge(int max, int... age);

4、创建数据库

@Database(entities = { User.class }, version = 1,exportSchema = false)
public abstract class UserDatabase extends RoomDatabase {

    private static final String DB_NAME = "UserDatabase.db";
    private static volatile UserDatabase instance;

    static synchronized UserDatabase getInstance(Context context) {
        if (instance == null) {
            instance = create(context);
        }
        return instance;
    }

    private static UserDatabase create(final Context context) {
        return Room.databaseBuilder(
            context,
            UserDatabase.class,
            DB_NAME).build();
    }

    public abstract UserDao getUserDao();
}

这里使用@Database注解该类并添加了表名数据库版本(每当我们改变数据库中的内容时它都会增加),所以这里使用exportSchema = false

注意:除了添加表映射的类以及和数据库版本外,还要添加exportSchema = false否则会报警告。 Error:(10, 17) 警告: Schema export directory is not provided to the annotation processor so we cannot export the schema. You can either provide room.schemaLocation annotation processor argument OR set exportSchema to false.

我们抽象了getUserDao()方法,这是必要的。

5、使用数据库 我们终于能够操作我们的数据库了。但是所有的操作必须在后台线程中完成。你可以通过使用AsyncTaskThreadHandlerRxJava或其它方式来完成。 如果没有在后台线程执行,并且也没有说明可以在主线程操作的话,就会报以下错误。

Caused by: java.lang.IllegalStateException: Cannot access database on the main thread since it may potentially lock the UI for a long period of time.

例如,我们可以像下面这样插入数据

User user=new User();
user.setName("name1");
user.setAge(18);
UserDatabase
        .getInstance(context)
        .getUserDao()
        .insert(user);

或者这样

List<User> allUsers = UserDatabase
        .getInstance(RoomActivity.this)
        .getUserDao()
        .getAllUsers();

好了,基本的使用的方式就这些了。未完待续

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏函数式编程语言及工具

PICE(2):JDBCStreaming - gRPC-JDBC Service

   在一个akka-cluster环境里,从数据调用的角度上,JDBC数据库与集群中其它节点是脱离的。这是因为JDBC数据库不是分布式的,不具备节点位置透明化...

770
来自专栏Spark生态圈

Spark 实现MySQL update操作

目前 spark 对 MySQL 的操作只有 Append,Overwrite,ErrorIfExists,Ignore几种表级别的模式,有时我们需要对表进行行...

1512
来自专栏岑玉海

RavenDb学习(二)简单的增删查改

在上一节当中已经介绍了RavenDb的文档设计模式,这一节我们要具体讲一讲如何使用api去访问RavenDb 1.连接RavenDb var docum...

3455
来自专栏码匠的流水账

聊聊storm的WindowedBolt

storm-2.0.0/storm-client/src/jvm/org/apache/storm/topology/IWindowedBolt.java

884
来自专栏分布式系统进阶

Kafka的Request和Response

每个Request和Response都由RequestHeader(ResponseHeader) + 具体的消费体构成;

642
来自专栏james大数据架构

C#调用SQL中的存储过程中有output参数,存储过程执行过程中返回信息

C#调用SQL中的存储过程中有output参数,类型是字符型的时候一定要指定参数的长度。不然获取到的结果总是只有第一字符。本人就是由于这个原因,折腾了很久。在此...

1887
来自专栏Samego开发资源

数据库Dao层抽象出BasicDao类 | 许久没碰Java了、致Java初学者

1534
来自专栏linux驱动个人学习

高通HAL层之bmp18x.cpp

下面bmp18x sensor为例进行分析。 BMP18x Sensor: 我们以打开bmp180为例,代码为hardware\qcom\sensors\Bmp...

3557
来自专栏函数式编程语言及工具

浅谈Slick(2)- Slick101:第一个动手尝试的项目

   看完Slick官方网站上关于Slick3.1.1技术文档后决定开始动手建一个项目来尝试一下Slick功能的具体使用方法。我把这个过程中的一些了解和想法记录...

2229
来自专栏专注研发

MybatisPlus之-----BaseMapper

MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生

1833

扫码关注云+社区