如何在Kotlin数据类中实现属性值约束？

当然可以在Kotlin数据类中给属性设置约束，而且有几种优雅的方式来实现，完全能满足你不局限于String类型、且无需抛出IllegalArgumentException的需求～下面就结合你的Java示例场景，给出几种实用方案：

1. 次级构造器处理简单约束 #

这种方式对应你示例2的Java构造器校验逻辑，我们可以通过次级构造器接收原始参数，处理约束后再调用主构造器赋值，完全自定义约束逻辑（比如截断过长字符串、修正非法数值等）：

data class TotallyMadeUpClass(
    val username: String,
    val age: Int
) {
    // 次级构造器：接收原始参数，处理约束后传递给主构造器
    constructor(rawUsername: String, rawAge: Int) : this(
        username = if (rawUsername.length > 10) rawUsername.substring(0, 10) else rawUsername,
        age = if (rawAge < 0) 0 else rawAge
    )
}

// 使用示例
val user = TotallyMadeUpClass("superlongusername123", -5)
println(user.username) // 输出 "superlonguse"
println(user.age)      // 输出 0

这种方案适合简单的、仅针对当前数据类的约束，逻辑清晰且无额外依赖。

2. 委托属性实现可复用约束 #

如果你的约束逻辑需要在多个属性或数据类中复用，或者需要给可变属性（var）添加约束（类似Java的setter校验），可以用委托属性来封装校验逻辑：

首先定义一个通用的委托类，负责处理约束：

class ConstrainedProperty<T>(
    private var value: T,
    private val validator: (T) -> T // 校验器：输入原始值，返回符合约束的结果
) {
    operator fun getValue(thisRef: Any?, property: KProperty<*>): T = value
    operator fun setValue(thisRef: Any?, property: KProperty<*>, newValue: T) {
        value = validator(newValue)
    }
}

// 扩展函数，简化委托的使用
fun <T> constrained(initialValue: T, validator: (T) -> T) = ConstrainedProperty(initialValue, validator)

然后在数据类中直接使用这个委托：

data class TotallyMadeUpClass(
    var username: String by constrained("") {
        if (it.length > 10) it.substring(0, 10) else it
    },
    var age: Int by constrained(0) {
        if (it < 0) 0 else it
    }
)

// 使用示例
val user = TotallyMadeUpClass()
user.username = "toolongusername"
user.age = -10
println(user.username) // 输出 "toolonguser"
println(user.age)      // 输出 0

这种方案的优势是高度复用，不管是String、Int还是其他自定义类型，都能通过传入不同的校验器来实现约束，而且对可变属性的修改会自动触发校验。

3. 内联类（Value Class）实现类型安全约束 #

如果你的约束是针对特定类型的（比如限制用户名长度、年龄范围），并且希望从类型层面保证属性值一定合法，可以用内联类来包装属性：

@JvmInline
value class ValidUsername(private val value: String) {
    // 提供获取原始值的方法
    fun asString() = value

    companion object {
        // 工厂方法：处理输入值，返回合法的ValidUsername实例
        fun from(input: String): ValidUsername {
            val safeUsername = if (input.length > 10) input.substring(0, 10) else input
            return ValidUsername(safeUsername)
        }
    }
}

// 数据类中直接使用内联类类型
data class TotallyMadeUpClass(
    val username: ValidUsername,
    val age: Int
)

// 使用示例
val user = TotallyMadeUpClass(ValidUsername.from("extremelylongname"), 30)
println(user.username.asString()) // 输出 "extremelylo"

这种方案的核心是类型安全：只要username属性是ValidUsername类型，就一定符合约束，避免了非法值的传入，非常适合需要严格保证数据合法性的场景。

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