[译] 使用Room进行持久化存储---综述

本文翻译自官网
使用Room进行持久化存储---综述
通过 Room entities 定义数据 ---Room 系列(1)
使用 Room 的 DAO 访问数据---Room 系列（2)
Android 中使用 Room 实践
Room 提供了一个建立在 SQLite 之上的抽象层，使得我们能够更流畅的进行数据库访问。
对于处理大量结构化数据的应用来说，将数据持久化存储到本地处理是一种较好的方式。 通常，我们会缓存相关的数据，当用户没有网络的时候，可以进行离线浏览，当设备在线之后，在同步数据。
而 Room 实际上就专注于这种方式。我们强烈推荐你使用 Room 替代 SQLite。当然，如果你更喜欢使用 SQLite API，Android仍然支持直接使用 SQLite 进行数据库访问。
在 Room 中，有三个主要概念：

• Database：数据库的实际持有者，底层连接的主要访问点。以 @Database 进行注解的类，应该满足以下几个条件：1. 这是一个抽象类，继承自 RoomDatabase；2. 包含一系列与该数据库相关的 entity ；3. 至少有一个方法返回以 @Dao 进行注解的对象，同时，该方法没有参数。
  在运行的时候，可以通过调用 Room.databaseBuilder() 或者 Room.inMemoryDatabaseBuilder() 方法请求一个 Database 实例。

 // User and Book are classes annotated with @Entity.
 @Database(version = 1, entities = {User.class, Book.class})
 abstract class AppDatabase extends RoomDatabase() {
     // BookDao is a class annotated with @Dao.
     abstract public BookDao bookDao();
     // UserDao is a class annotated with @Dao.
     abstract public UserDao userDao();
     // UserBookDao is a class annotated with @Dao.
     abstract public UserBookDao userBookDao();
 }

• Entity:代表了 database 中的一张 table 。
• DAO:包含有访问数据库的方法。
  room_architecture.png

User.java

@Entity
public class User {
    @PrimaryKey
    private int uid;

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

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

    // Getters and setters are ignored for brevity,
    // but they're required for Room to work.
}

UserDao.java

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

    @Query("SELECT * FROM user WHERE uid IN (:userIds)")
    List<User> loadAllByIds(int[] userIds);

    @Query("SELECT * FROM user WHERE first_name LIKE :first AND "
           + "last_name LIKE :last LIMIT 1")
    User findByName(String first, String last);

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

    @Delete
    void delete(User user);
}

AppDatabase.java

@Database(entities = {User.class}, version = 1)
public abstract class AppDatabase extends RoomDatabase {
    public abstract UserDao userDao();
}

创建了上述的文件之后，通过下面代码获取一个数据库实例：

AppDatabase db = Room.databaseBuilder(getApplicationContext(),
        AppDatabase.class, "database-name").build();

注意，通常，我们应该以单例模式实例化 AppDatabase 对象，因为每个 RoomDatabase 实例花销比较大，而我们往往不需要这么多的实例化对象。