Room进阶：从入门到实战的五大核心能力

说实话，Room 的基本增删改查用起来确实挺爽的。但真正到了项目里，你会发现光会 CRUD 远远不够。今天我就把 Room 进阶的五个关键点掰开揉碎了讲给你听——这些都是我在实际项目中踩过坑、填过坑之后沉淀下来的经验。

1. @Query 注解：复杂查询的写法与技巧

@Query 是 Room 里最灵活的注解。说白了，你只要会写 SQL，就能用它做任何查询。我个人习惯把复杂查询都写在 DAO 接口里，这样业务层调用起来特别清爽。

先看一个基础的多条件查询：

@Dao
public interface UserDao {
    @Query("SELECT * FROM users WHERE age > :minAge AND name LIKE '%' || :keyword || '%'")
    List<User> searchUsers(int minAge, String keyword);
    
    @Query("SELECT * FROM users ORDER BY createTime DESC LIMIT :limit")
    List<User> getRecentUsers(int limit);
}

我在项目中遇到过最头疼的是 JOIN 查询。比如用户和订单关联查询：

@Query("SELECT u.name, o.orderId, o.totalAmount " +
       "FROM users u INNER JOIN orders o ON u.id = o.userId " +
       "WHERE u.id = :userId")
LiveData<List<UserOrder>> getUserOrders(int userId);

2. @Insert / @Update / @Delete 注解：批量操作与返回值

这三个注解看起来简单，但用好它们能省不少事。我刚开始用 Room 时，以为 @Insert 只能插一条数据，后来才发现它支持批量操作。

@Dao
public interface UserDao {
    // 单条插入，返回主键
    @Insert
    long insert(User user);
    
    // 批量插入，返回主键列表
    @Insert
    List<Long> insertAll(List<User> users);
    
    // 更新，返回受影响的行数
    @Update
    int update(User user);
    
    // 删除，返回删除的行数
    @Delete
    int delete(User user);
}

嗯，这里要注意：@Update 和 @Delete 是根据主键来匹配的。如果你只传了一个部分字段的对象，Room 会把它当成完整对象来处理。我曾经犯过这个错——更新时只传了 id 和 name，结果其他字段全被清空了。

3. @Transaction 事务支持：保证数据一致性

为什么需要事务？你想想看，如果同时要插入订单和扣减库存，其中一个失败了怎么办？数据就不一致了。@Transaction 就是用来解决这个问题的。

@Dao
public interface OrderDao {
    @Transaction
    @Query("SELECT * FROM orders WHERE userId = :userId")
    List<UserWithOrders> getUserWithOrders(int userId);
    
    @Transaction
    default void placeOrder(Order order, Product product) {
        insertOrder(order);
        updateStock(product.getId(), product.getStock() - 1);
    }
    
    @Insert
    void insertOrder(Order order);
    
    @Query("UPDATE products SET stock = :stock WHERE id = :productId")
    void updateStock(int productId, int stock);
}

我个人习惯把事务方法写成 default 方法放在 DAO 里。这样所有数据库操作都集中在一个地方，维护起来特别方便。记得有一次线上出了个 bug，就是因为事务没处理好，订单下了但库存没扣——从那以后我对事务就特别敏感。

4. TypeConverter 类型转换器：让 Room 支持复杂类型

Room 默认只支持基本类型和它们对应的包装类。但实际开发中，我们经常要存 Date、List、Map 这些类型。这时候就需要 TypeConverter 出马了。

举个例子，存一个日期类型：

public class Converters {
    @TypeConverter
    public static Date fromTimestamp(Long value) {
        return value == null ? null : new Date(value);
    }
    
    @TypeConverter
    public static Long dateToTimestamp(Date date) {
        return date == null ? null : date.getTime();
    }
}

// 在 Database 类中注册
@Database(entities = {User.class}, version = 1)
@TypeConverters(Converters.class)
public abstract class AppDatabase extends RoomDatabase {
    // ...
}

再比如存一个 List<String>：

public class StringListConverter {
    @TypeConverter
    public static List<String> fromString(String value) {
        if (value == null) return new ArrayList<>();
        return new Gson().fromJson(value, new TypeToken<List<String>>(){}.getType());
    }
    
    @TypeConverter
    public static String fromList(List<String> list) {
        return new Gson().toJson(list);
    }
}

5. 预填充数据库：应用首次启动就有数据

有些场景下，我们希望用户第一次打开 App 时数据库里就已经有数据了。比如城市列表、国家代码、常用配置等。Room 提供了预填充功能，用起来很简单。

首先，在 assets 目录下放一个预填充的数据库文件（比如 my_database.db）。然后在构建 Database 时指定：

Room.databaseBuilder(context, AppDatabase.class, "my_database.db")
    .createFromAsset("databases/my_database.db")
    .build();

如果你是从文件系统预填充：

Room.databaseBuilder(context, AppDatabase.class, "my_database.db")
    .createFromFile(new File("path/to/prefilled.db"))
    .build();

预填充数据库的生成方式也很简单：你可以在本地写一个测试 App，运行后把生成的数据库文件复制出来，放到 assets/databases 目录下就行。或者用 SQLite 工具手动创建好再放进去。

---

好了，Room 进阶的五个核心能力就讲到这里。说实话，这些内容看起来多，但用熟了之后你会发现它们其实是一套组合拳。@Query 负责查，@Insert/@Update/@Delete 负责写，@Transaction 保证一致性，TypeConverter 扩展类型支持，预填充解决初始化问题——五个点串起来，基本能应对绝大多数业务场景。

你在实际项目中遇到什么问题，欢迎随时交流。毕竟这些坑我都踩过，能帮你省点时间也是好的。