如何创建可用于Android Room架构的SQLite视图？

嘿，我刚好在项目里处理过类似的需求，Room其实完全支持创建和使用SQLite视图，只是这块内容在官方文档里不算特别显眼，我给你一步步拆解示例，你看完就能快速上手。

核心：用@DatabaseView定义视图 #

Room专门提供了@DatabaseView注解来创建视图，你只需要把原来的SQL视图查询语句填进去，再定义一个对应的数据类来映射视图的返回字段就行。

步骤1：先定义基础实体类

假设你的应用里有用户表和订单表，先把这两个实体类写好：

@Entity(tableName = "users")
data class User(
    @PrimaryKey val userId: Int,
    val name: String,
    val email: String
)

@Entity(tableName = "orders")
data class Order(
    @PrimaryKey val orderId: Int,
    val userId: Int,
    val amount: Double
)

步骤2：创建视图类

比如你需要一个视图来统计每个用户的订单数量和消费总额，用@DatabaseView包裹你的SQL查询，然后定义对应的数据类：

// 可以通过name参数指定视图在数据库中的实际名称，默认是类名
@DatabaseView(
    name = "user_order_summary",
    sql = "SELECT u.userId, u.name, u.email, COUNT(o.orderId) as total_orders, SUM(o.amount) as total_spent " +
          "FROM users u LEFT JOIN orders o ON u.userId = o.userId " +
          "GROUP BY u.userId, u.name, u.email"
)
data class UserOrderSummary(
    val userId: Int,
    val name: String,
    val email: String,
    val total_orders: Int,
    val total_spent: Double? // 左连接可能为null，所以用可空类型
)

步骤3：在Database类中注册视图

把视图添加到Room数据库的views参数里，这样Room才会在创建数据库时生成对应的视图：

@Database(
    entities = [User::class, Order::class],
    views = [UserOrderSummary::class],
    version = 1,
    exportSchema = true
)
abstract class AppDatabase : RoomDatabase() {
    // 常规实体的Dao
    abstract fun userDao(): UserDao
    abstract fun orderDao(): OrderDao
    
    // 视图对应的Dao（只读，因为视图不能做增删改）
    abstract fun userOrderSummaryDao(): UserOrderSummaryDao
}

步骤4：编写视图的Dao接口

因为视图是只读的，所以Dao里只能定义查询方法，不能有@Insert、@Update这类修改操作：

@Dao
interface UserOrderSummaryDao {
    // 查询所有用户的订单统计
    @Query("SELECT * FROM user_order_summary")
    suspend fun getAllUserSummaries(): List<UserOrderSummary>

    // 根据用户ID查询单个统计结果
    @Query("SELECT * FROM user_order_summary WHERE userId = :userId")
    suspend fun getUserSummaryById(userId: Int): UserOrderSummary?

    // 甚至可以在查询视图时添加额外过滤条件
    @Query("SELECT * FROM user_order_summary WHERE total_orders > :minOrderCount")
    suspend fun getActiveUsers(minOrderCount: Int): List<UserOrderSummary>
}

复杂视图的注意事项 #

• 支持所有SQLite语法：只要你的SQL语句在原生SQLite里能运行，就能直接放到@DatabaseView的sql参数里，包括子查询、函数调用（比如DATE()、LOWER()）、多表关联等。
• 视图迁移：如果后续修改了视图的SQL语句，或者依赖的实体表结构变化，需要更新数据库版本，并编写迁移脚本，Room会自动处理视图的重建。
• 视图名称冲突：如果你的视图名称和实体表名重复，一定要通过@DatabaseView的name参数指定唯一名称。

这样你就能把原来的复杂SQLite视图无缝迁移到Room里了，要是你有具体的复杂视图场景（比如带嵌套子查询的），可以把SQL贴出来，我帮你调整适配Room的写法~

内容的提问来源于stack exchange，提问作者Dreamers Org