[译] 从 SQLite 逐步迁移到 Room

public int getId() { return mId; }

public String getUserName() { return mUserName; }
}

创建 Room 数据库

创建一个继承 RoomDatabase 的抽象类。在 @Database 注解中，列出所有你已创建的 entity 类。现在，我们就不用再创建 DAO 类了。

更新你数据库版本号并生成一个 Migration 对象。如果你没改数据库的 schema，你仍需要生成一个空的 Migration 对象让 Room 保留已有的数据。

@Database(entities = {},
version = <incremented_sqlite_version>)
public abstract class AppDatabase extends RoomDatabase {
private static UsersDatabase INSTANCE;
static final Migration MIGRATION_<sqlite_version>_<incremented_sqlite_version>
= new Migration(<sqlite_version>, <incremented_sqlite_version>) {
@Override public void migrate(
SupportSQLiteDatabase database) {
// 因为我们并没有对表进行更改，
// 所以这里没有什么要做的
}
};

更新使用 SQLiteOpenHelper 的类

一开始，我们的 LocalDataSource 类使用 CustomOpenHelper 进行工作，现在我要把它更新为使用 **SupportSQLiteOpenHelper**，这个类可以从 RoomDatabase.getOpenHelper() 获得。

public class LocalUserDataSource {
private SupportSQLiteOpenHelper mDbHelper;
LocalUserDataSource(@NonNull SupportSQLiteOpenHelper helper) {
mDbHelper = helper;
}

因为 SupportSQLiteOpenHelper 并不是直接继承 SQLiteOpenHelper，而是对它的一层包装，我们需要更改获得可写可读数据库的调用方式，并使用 SupportSQLiteDatabase 而不再是 SQLiteDatabase。

SupportSQLiteDatabase db = mDbHelper.getWritableDatabase();

SupportSQLiteDatabase 是一个数据库抽象层，提供类似 SQLiteDatabase 中的方法。因为它提供了一个更简洁的 API 去执行插入和查询数据库的操作，代码相比以前也需要做一些改动。

对于插入操作，Room 移除了可选的 nullColumnHack 参数。使用 SupportSQLiteDatabase.insert 代替 SQLiteDatabase.insertWithOnConflict。

@Override
public void insertOrUpdateUser(User user) {
SupportSQLiteDatabase db = mDbHelper.getWritableDatabase();

ContentValues values = new ContentValues();
values.put(COLUMN_NAME_ENTRY_ID, user.getId());
values.put(COLUMN_NAME_USERNAME, user.getUserName());

• db.insertWithOnConflict(TABLE_NAME, null, values,

•    SQLiteDatabase.CONFLICT_REPLACE);
  

• db.insert(TABLE_NAME, SQLiteDatabase.CONFLICT_REPLACE,
• values);
  db.close();
  }

要查询的话，SupportSQLiteDatabase 提供了4种方法：

Cursor query(String query);
Cursor query(String query, Object[] bindArgs);
Cursor query(SupportSQLiteQuery query);
Cursor query(SupportSQLiteQuery query, CancellationSignal cancellationSignal);

如果你只是简单地使用原始的查询操作，那在这里就没有什么要改的。如果你的查询是较复杂的，你就得通过 SupportSQLiteQueryBuilder 创建一个 SupportSQLiteQuery。

举个例子，我们有一个 users 表，只想获得表中按名字排序的第一个用户。下面就是实现方法在SQLiteDatabase 和 SupportSQLiteDatabase 中的区别。

public User getFirstUserAlphabetically() {
User user = null;
SupportSQLiteDatabase db = mDbHelper.getReadableDatabase();
String[] projection = {
COLUMN_NAME_ENTRY_ID,
COLUMN_NAME_USERNAME
};

// 按字母顺序从表中获取第一个用户

• Cursor cursor = db.query(TABLE_NAME, projection, null,
• null, null, null, COLUMN_NAME_USERNAME + “ ASC “, “1”);

• SupportSQLiteQuery query =

• SupportSQLiteQueryBuilder.builder(TABLE_NAME)

•                       .columns(projection)
  

•                       .orderBy(COLUMN_NAME_USERNAME)
  

•                       .limit(“1”)
  

•                       .create();
  

• Cursor cursor = db.query(query);

if (c !=null && c.getCount() > 0){
// read data from cursor
…
}
if (c !=null){
cursor.close();
}
db.close();
return user;
}

如果你没有对你的 SQLiteOpenHelper 实现类进行测试的话，那我强烈推荐你先测试下再进行这个迁移的工作，避免产生相关 bug。

其余的 PR

既然你的数据层已经在使用 Room，你可以开始逐渐创建 DAO 类（附带测试）并通过 DAO 的调用替代 Cursor 和 ContentValue 的代码。

像在 users 表中按名字顺序查询第一个用户这个操作应该定义在 UserDao 接口中。

@Dao
public interface UserDao {
@Query(“SELECT * FROM Users ORDERED BY name ASC LIMIT 1”)
User getFirstUserAlphabetically();
}

这个方法会在 LocalDataSource 中被调用。

public class LocalDataSource {
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

最后我还整理了很多Android中高级的PDF技术文档。以及一些大厂面试真题解析文档。

Android高级架构师之路很漫长，一起共勉吧！

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

-1712820339967)]

Android高级架构师之路很漫长，一起共勉吧！

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！