SQLite 在 Room 数据库中的默认值（Kotlin）

阅读更多： SQLite 教程

设置默认值

在 Room 中，我们可以通过在实体类的属性中使用 @ColumnInfo 注解来设置默认值。 @ColumnInfo 注解包含一个 defaultValue 属性，可以用来指定默认值。我们来看一个例子：

@Entity(tableName = "users")
data class User(
    @PrimaryKey
    val id: Int,
    @ColumnInfo(name = "username")
    val username: String,
    @ColumnInfo(name = "age")
    val age: Int = 18
在上面的例子中，User 实体类中的 age 属性通过 defaultValue = 18 来设置默认值为 18。这意味着如果在插入新行时没有为 age 属性提供特定的值，那么它将被设置为默认值 18。
查询默认值
在查询数据时，如果某个列的值为空，则默认使用其默认值。例如，以下是一个查询用户信息的例子：
interface UserDao {
    @Query("SELECT * FROM users WHERE id = :userId")
    fun getUser(userId: Int): User
在上面的例子中，如果用户表中的某一行的 age 列为空，那么在查询时将返回默认的年龄值 18。
更新默认值
在 Room 中，我们还可以更新默认值。如果要更新某个列的默认值，我们可以通过更改实体类中的 defaultValue 属性来实现。例如，下面是一个更新用户年龄默认值的例子：
@Entity(tableName = "users")
data class User(
    @PrimaryKey
    val id: Int,
    @ColumnInfo(name = "age")
    val age: Int = 20
在上面的例子中，我们将用户年龄的默认值从 18 更新为 20。这意味着如果在插入新行时没有为 age 属性提供特定的值，那么它将被设置为默认值 20。

自定义默认值处理
除了使用属性的默认值之外，我们还可以自定义更复杂的默认值处理逻辑。在 Room 中，我们可以使用 TypeConverter 来实现自定义默认值的处理。例如，假设我们希望在插入新用户时，如果未提供性别信息，则将其默认设置为“未知”。我们可以创建一个 GenderConverter 类来处理这个逻辑：
class GenderConverter {
    @TypeConverter
    fun fromString(value: String?): Gender {
        return when (value) {
            null -> Gender.UNKNOWN
            else -> Gender.valueOf(value)
    @TypeConverter
    fun toString(gender: Gender?): String {
        return gender?.name ?: Gender.UNKNOWN.name
enum class Gender {
    UNKNOWN,
    MALE,
    FEMALE
在上面的例子中，我们创建了一个名为 GenderConverter 的类，其中包含两个方法：fromString 和 toString。这些方法用于将 Gender 枚举类型转换为字符串和从字符串中解析出 Gender 枚举类型。通过使用 TypeConverter 注解将此类与 Room 关联起来，我们可以自定义性别的默认值处理。
在本文中，我们介绍了在使用 Kotlin 的 Room 数据库中处理 SQLite 默认值的方法。我们可以在实体类中使用 @ColumnInfo 注解来设置默认值，并且在查询时如果列的值为空，则使用默认值。此外，我们还了解了如何通过更新实体类中的 defaultValue 属性来更新默认值，并且可以使用自定义的 TypeConverter 来处理更复杂的默认值逻辑。希望本文对你在使用 Room 数据库处理默认值时有所帮助！