简介

在2017年Google IO大会上推出的官方数据框框架，其实际上就是对SQLite做了一层封装。基本原理是通过编译期注解，根据你配置的表名和表字段生成对应的代码，减少开发者的工作量。

使用

1、添加Room依赖

dependencies {
 api "android.arch.persistence.room:runtime:$1.1.1"
 annotationProcessor "android.arch.persistence.room:compiler:$1.1.1"
}

注意，如果你是将room封装在module里面，然后再将module引入到主工程的话，需要将 annotationProcessor “android.arch.persistence.room:compiler:$1.1.1” 这个也拷贝到主工程的build.gradle里面，要不然注解不能够正常生成，项目也运行不起来。

2、使用

在使用的过程中，我们需要一个Entity、一个Dao和一个DataBase。

1）、Entry类
使用@Entity注解，表名这个是其中一张表，另外，如果在属性的签名不加任何注解的话，这个属性就是一个字段名，当然，如果你不想直接使用属性名作为字段名的话，可以加上 @ColumnInfo(name = “message”)进行自定义。如果这个实体类的某个字段不想存进数据库的话，可以加上@Ingore.是否是主键、外键等也有对应的注解。

@Entity(tableName = RoomConstant.FIRST_TABLE)
public class FirstTable {

    @PrimaryKey(autoGenerate = true)
    private int id;

    @ColumnInfo(name = "message")
    private String message;

    public String getInfo() {
        return info;
    }

    public void setInfo(String info) {
        this.info = info;
    }

    @ColumnInfo(name = "info")
    private String info;

    public void setMessage(String message){
        this.message = message;
    }

    public int getId() {
        return id;
    }

    public String getMessage() {
        return message;
    }

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

2）、Dao 类
这个类的作用是配置对应的数据库操作方法，比如查询、更新、删除等，注意，类名前面需要@Dao注解。如果是全部查询、删除等操作，可以直接传入对应的entry类，如果是根据某个字段去查询，需要自己写对应的sql语句。

@Dao
public interface BaseDao<T> {

    @Insert
    void insertItem(T item);//插入单条数据

    @Insert
    void insertItems(List<T> items);//插入list数据

    @Delete
    void deleteItem(T item);//删除item

    @Update
    void updateItem(T item);//更新item
}

@Dao
public interface FistTableDao extends BaseDao<FirstTable>{

    //如果是查询

    @Query("SELECT * FROM first_table")
    List<FirstTable> getAll();

    @Query("SELECT * FROM first_table WHERE id IN (:ids)")
    List<FirstTable> loadAllByIds(int[] ids);

    @Query("SELECT * FROM first_table WHERE :message LIKE :message")
    FirstTable findByMessage(String message);
}

3）、DataBase类
使用@DataBase注解。里面需要配置你要操作的entry类，可以配置一个或者多个，version表名这个是哪个版本，如果升级需要修改的就是这里。升级的策略有两种，一种是完全不要旧版本的数据，增加fallbackToDestructiveMigration即可，如果有自定义的升级策略….后面再讲。allowMainThreadQueries表明是否可以在主线程进行操作，一般不建议增加这个配置。配置abstract FistTableDao userDao(); 就可以获取到进行数据库操作的实例。

@Database(entities = {FirstTable.class, SecondTable.class, ThirdTable.class}, version = RoomConstant.VERSION, exportSchema = false)
public abstract class MyRoomDataBase extends RoomDatabase {

    private static MyRoomDataBase mInstance;

    public static MyRoomDataBase getInstance(Context context) {
        if (mInstance == null) {
            synchronized (MyRoomDataBase.class) {
                if (mInstance == null) {
                    mInstance = Room.databaseBuilder(context, MyRoomDataBase.class, DB_NAME)
                            .fallbackToDestructiveMigration() //直接删除旧版数据
                            .allowMainThreadQueries()   //可以在主线程操作
                            .build();
                }
            }
        }
        return mInstance;
    }

    public static void onDestroy() {
        mInstance = null;
    }

    public abstract FistTableDao userDao();

    public abstract SecondTableDao secondTableDao();

    public abstract ThirdTableDao thirdTableDao();
}

3、设置 Schema 的位置

存储展示数据库的结构信息，如果不设置的话，需要再database类上配置exportSchema = false，要不然编译的时候会出现警告。

defaultConfig {
        minSdkVersion 19
        targetSdkVersion 26

        javaCompileOptions {
            annotationProcessorOptions {
                arguments =["room.schemaLocation":"$projectDir/schemas".toString()]
            }
        }
}

4、查询

经过上面的配置之后，就可以获取到对应的Dao实例进行操作，

MyRoomDataBase myRoomDataBase = MyRoomDataBase.getInstance(baseContext);

    private static void operateFristTable(MyRoomDataBase myRoomDataBase) {
        FistTableDao fistTableDao = myRoomDataBase.userDao();
        FirstTable firstTable = new FirstTable();
        firstTable.setMessage("firstTableMessage1");
        firstTable.setInfo("第一个表");
        fistTableDao.insertItem(firstTable);

//        firstTable.delete(firstTable);

        FirstTable item  = fistTableDao.findByMessage("firstTableMessage1");
        if (item != null) {
            Log.d(TAG, item.getInfo());
        }

        List<FirstTable> firstTableList = fistTableDao.loadAllByIds(new int[]{0,1,2});

        if (firstTableList != null) {
            Log.d(TAG, "<-firstTableSize->" + firstTableList.size());
        }
    }

5、升级

如果需要进行数据库的升级，需要再构造database 实例的时候，调用addMigrations进行配置

Room.databaseBuilder(getApplicationContext(),  MyRoomDataBase.class,  DB_NAME).  (MIGRATION_1_2, MIGRATION_2_3).build();

static final Migration MIGRATION_1_2 = new Migration(1, 2) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        database.execSQL("CREATE TABLE `second_table` (`id` INTEGER, "
                + "`name` TEXT, PRIMARY KEY(`id`))");
    }
};

static final Migration MIGRATION_2_3 = new Migration(2, 3) {
    @Override
    public void migrate(SupportSQLiteDatabase database) {
        database.execSQL("alert table first_table "
                + "add column age integer");
    }
};