介绍

Room 持久层库提供了一个方便我们访问 SQLite 数据库的抽象层(an abstraction layer )，帮助我们更好的在 APP 上创建我们的数据缓存，能够让 APP 即使在没有网络的情况也能正常使用。

架构图

image.png

引用：

    //room
    def room_version = "2.2.1"
    implementation "androidx.room:room-runtime:$room_version"
    annotationProcessor "androidx.room:room-compiler:$room_version"

基础操作：

1.定义Entity实例，其对应一个表

@Entity
public class Person {

    @PrimaryKey(autoGenerate = true)
    public int uid;

    @ColumnInfo(name = "first_name")
    public String firstName;

    @ColumnInfo(name = "last_name")
    public String lastName;

    public int age;

}

PrimaryKey为主键，autoGenerate自增选项。
ColumnInfo对应其表字段。
没有则默认参数名为字段名。
Ignore代码忽略。

2.定位DAO文件

@Dao
public interface MyDao {

    @Query("SELECT * from person")
    List<Person> getPersons();

    @Query("SELECT * from person WHERE uid IN (:ids)")
    List<Person> loadAllById(int [] ids);

    @Query("SELECT * from person WHERE first_name like :firstName AND last_name like :lastName ")
    Person findByName(String firstName,String lastName);

    @Insert
    void inert(Person ...persons);

    @Delete
    void delete(Person person);
}

DAO文件需要使用@Dao注解，内部方法增删改查有对应的注解，查询操作注解value内是具体的SQL语句。

3.定义Database文件

@Database(entities = {Person.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract MyDao myDao();
}

Database文件使用@Database注解，参数entities内存放的是对应表所对应的Entity的class，version代表版本号。

4.使用

 final AppDatabase db = Room.databaseBuilder(App.getInstance(),
                AppDatabase.class, "person").build();
 db.myDao().inert(insertPerson);

获取Database 实例，然后调用其内部方法获取到DAO实例,从而操作数据。
具体的实现方法不需要我们操作，因为引用annotationProcessor "androidx.room:room-compiler:$room_version，所以在编译是ROOM内部会自动生成对应的文件，这些文件实现了具体的访问操作。

值得注意的在主线程访问数据库，会报错：

Cannot access database on the main thread since it may potentially lock the UI for a long period of time.

因此我们需要在子线程完成访问操作，主线程只接受结果就好。