AAC---Room使用

None_Ling

发布于 2019-02-25 16:40:38

1.3K0

发布于 2019-02-25 16:40:38

Room介绍

Room是AAC推荐的基于SQLite的ORM数据库框架。通过注解的方式来进行数据库的配置，以及SQL的查询，并且在编译的过程中，会检查SQL以及数据库配置等的正确性，同时也支持外键、事务等。虽然没有ObjectBox，GreenDao等效率高，不过用起来也比较方便。

Room Database

ObjectBox是非SQLite的ORM数据库框架，它自定义了自己的数据库文件，它的文件只有官方提供的工具才能打开，并且对于外键、主键等支持也比较完备，并且效率比Room以及GreenDao等基于SQLite的框架高非常多，不过在真正的产品中使用的话，以后也就不能再升级框架了。

Room使用

Gradle配置，在app的build.gradle中添加如下配置

dependencies {
    def room_version = "1.1.1"

    implementation "android.arch.persistence.room:runtime:$room_version"
    annotationProcessor "android.arch.persistence.room:compiler:$room_version"

    // optional - RxJava support for Room
    implementation "android.arch.persistence.room:rxjava2:$room_version"

    // optional - Guava support for Room, including Optional and ListenableFuture
    implementation "android.arch.persistence.room:guava:$room_version"

    // Test helpers
    testImplementation "android.arch.persistence.room:testing:$room_version"
}

定义数据库

使用entities定义在数据库中存储的实体结构
使用version定义数据库版本(数据库版本升级后续介绍)
在抽象类中，定义一个抽象方法提供DAO对象

@Database(entities = { UserData.class }, version = 1)
public abstract class UserDatabase extends RoomDatabase {
    public abstract UserDataDao userDataDao();
}

定义ORM对象结构，使用@Entity定义。
- Class属性需要定义成public或者提供setter/getter方法。
- 每个Entity需要定义至少一个PrimaryKey，也可以通过一个integer类型的Id定义@PrimaryKey(autoGenerate = true)自动生成Id
- 为了提升查询的速度，可以通过indices设置索引，如果需要保证属性数据的唯一性，则可以通过设置unique=true来保证
- 可以通过Entity中的foreignKeys来与另外一张表进行关联，设置外键

@Entity(tableName = "user_table",primaryKey = {"userName","userAge"}，
      indices = { @Index("userName"),
       @Index(value = { "userName", "userAge" }, unique = true) })
public class UserData {
    @PrimaryKey
    private String userName;
    @ColumnInfo(name = "user_age")
    private String userAge;
    @ColumnInfo
    private String userBirth;
    @Ignore
    private Bitmap mImage;
    ...
}

定义Dao用来定义执行SQL以及增删改查的操作

Query可以定义参数，通过:param的方式在编译期间，生成对应的SQL语句，从而进行查询
剩下插入，删除，更新的可以定义单个或者多个对象进行批量更新
除了查询外的操作都会是一个Transaction
插入，删除，更新操作都是根据PrimaryKey匹配进行操作的
Query操作可以返回Cursor，LiveData
Query的参数也可以是一个List对象，

@Dao
public interface UserDataDao {
    @Query("SELECT * FROM user_table")
    List<UserData> queryAll();

    @Query("SELECT * FROM user_table WHERE userAge = :age AND userName=:name")
    UserData querySingle(int age, String name);

    @Insert
    void insertAll(List<UserData> userList);

    @Insert
    void insertSingle(UserData user);

    @Update
    void updateAll(List<UserData> user);

    @Update
    void updateSingle(UserData user);

    @Delete
    void deleteAll(List<UserData> user);

    @Delete
    void deleteSingle(UserData user);
}

通过Room中的Builder获取数据库对象，并且获取DAO对象后，进行操作。

其中name为数据库名称

UserDatabase db = Room.databaseBuilder(getApplicationContext(), UserDatabase.class, "user_db").build();
        UserDataDao dao = db.userDataDao();
        dao.queryAll();

数据库版本升级

Room提供了Migration类进行数据库的升级，分三步

更新Entity结构

public class UserData {
    @PrimaryKey(autoGenerate = true)
    private String userName;
    @ColumnInfo
    private int userAge;
    @ColumnInfo
    private String userBirth;
    @Ignore
    private Bitmap mImage;
     ... 
}

更新数据库版本

@Database(entities = { UserData.class }, version = 2)
public abstract class UserDatabase extends RoomDatabase {
    public abstract UserDataDao userDataDao();
}

在Build数据库时，添加Migration进行数据库升级

UserDatabase db = Room.databaseBuilder(getApplicationContext(), UserDatabase.class, "user_db")
                .addMigrations(new Migration(1, 2) {
                    @Override
                    public void migrate(@NonNull SupportSQLiteDatabase database) {
            //  数据库版本从1升级到2，UserData的userAge字段从String变成了int，则需要使用ALTER修改表结构
             database.execSQL("ALTER TABLE user_table CHANGE userAge INTEGER;");
                    }
                })
                .addMigrations(new Migration(2, 3) {
                    @Override 
                    public void migrate(@NonNull SupportSQLiteDatabase database) {
          //  数据库版本从2升级到3
                    }
                }).build();