使用Room库将数据保存在本地数据库中

Room提供了一个SQLite的抽象层，可以在充分利用SQLite的同时访问流畅的数据库。

在Model - build.gradle添加依赖

implementation "android.arch.persistence.room:runtime:1.0.0"

处理不重要数量的结构化数据的应用程序可以从本地持久保存数据中获益。最常见的用例是缓存相关的数据。这样，当设备无法访问网络时，用户仍然可以在脱机状态下浏览该内容。设备重新联机后，任何用户启动的内容更改都会同步到服务器。

由于Room会为您处理这些问题，我们强烈建议使用Room而不是SQLite。但是，如果您更愿意直接使用SQLite API，请阅读使用SQLite保存数据。

注意：为了在您的应用中使用Room， 请将架构组件 工件添加到您应用的build.gradle文件中。

房间内有三个主要部分：

• 数据库： 包含数据库持有者，并作为与应用持久关系数据的底层连接的主要接入点。

  被注释的类 @Database应该满足以下条件：

  • 是一个扩展的抽象类 RoomDatabase。
  • 在注释中包含与数据库关联的实体列表。
  • 包含一个具有0个参数的抽象方法，并返回注释的类 @Dao。

  在运行时，您可以Database通过调用 Room.databaseBuilder()或 获取实例 Room.inMemoryDatabaseBuilder()。

• 实体：表示数据库中的一个表。

• DAO：包含用于访问数据库的方法。

这些组件以及它们与应用程序其余部分的关系如图1所示：

Room架构图

以下代码片段包含具有一个实体和一个DAO的示例数据库配置：

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 实例都相当昂贵，并且很少需要访问多个实例。