Java record 怎样在紧凑构造器中规范化输入

Java record 适合承载已经整理好的数据，但外部输入往往带有首尾空格、大小写不统一或不满足范围约束的值。处理这类输入时，可以在 record 的紧凑构造器中先规范化参数，再让构造器末尾的隐式赋值把结果写入组件字段。这样，后续 accessor、equals、hashCode 和序列化看到的都是同一份稳定状态。

官方地址：https://docs.oracle.com/en/java/javase/25/language/records.html

紧凑构造器的赋值边界是什么

下面的 UserKey 把用户名两端空格去掉，并把区域码统一成大写。紧凑构造器没有重复组件列表，也不需要手写字段赋值；参数处理完成后，隐式赋值才会发生。

public record UserKey(String username, String region) {
    public UserKey {
        // 先拒绝 null，避免 trim 和 toUpperCase 产生隐藏的空指针异常
        if (username == null || region == null) {
            throw new IllegalArgumentException("username 和 region 不能为 null");
        }

        // 规范化可接受的格式，结束构造器时会隐式写入 record 字段
        username = username.trim();
        region = region.trim().toUpperCase(Locale.ROOT);

        // 空字符串属于业务无效值，不能用默认值悄悄吞掉
        if (username.isEmpty() || region.isEmpty()) {
            throw new IllegalArgumentException("username 和 region 不能为空");
        }
    }
}

这里有一个容易误解的点：username 和 region 是构造器的隐式形式参数，不是可以重新声明的局部副本。直接给参数重新赋值，是把规范化结果交给 record 字段的关键动作。若在构造器里写 this.username = username，反而违反 record 对组件字段的特殊限制。

规范化与校验应该怎样分层

适合放进紧凑构造器的规则通常有两类。第一类是不会改变业务含义的表示统一，例如去除首尾空白、统一区域码大小写、把可接受的别名折叠成规范值。第二类是对象不变量，例如金额不能小于零、开始时间不能晚于结束时间；这类规则失败时应抛出明确异常。

public record PriceRange(String currency, BigDecimal minimum, BigDecimal maximum) {
    public PriceRange {
        // 统一货币代码的表示，但不把未知代码替换成默认货币
        if (currency == null || minimum == null || maximum == null) {
            throw new IllegalArgumentException("字段不能为 null");
        }
        currency = currency.trim().toUpperCase(Locale.ROOT);

        // 使用 compareTo 判断数值关系，避免 BigDecimal 的 scale 影响大小比较
        if (currency.isEmpty() || minimum.compareTo(BigDecimal.ZERO)  0) {
            throw new IllegalArgumentException("价格区间不合法");
        }
    }
}

不要把所有异常输入都“修正”为默认值。比如把空货币代码改成 CNY 会让调用方失去发现数据错误的机会；而把 " cn " 规范成 "CN"，通常仍然保留了原意。边界规则应在构造器内集中表达，使对象一旦构造成功就满足约束。

构造结果怎样确认确实被规范化

测试重点不是检查构造器内部变量，而是检查公开组件 accessor 返回的值。record 自动生成的 accessor 读取的是最终组件字段，因此它能直接证明隐式赋值使用了规范化后的参数。

如果 record 还会进入缓存键、集合或序列化链路，规范化应发生在这些边界之前。否则同一个逻辑用户可能因为大小写或空白产生多个 record 实例，虽然字段看起来相近，equals 和哈希值却不会相同。

紧凑构造器的适用边界

紧凑构造器适合“组件列表不变，只在入口整理和校验参数”的场景。如果要从一个完全不同的输入对象创建 record，可以增加替代构造器，但它必须调用规范构造器，例如 this(source.name(), source.region())。如果需要改变字段数量、允许延迟修改或保存额外实例状态，record 本身就不是合适的载体。

常见问题

紧凑构造器里为什么不写 this.username = username

record 组件字段由编译器管理，紧凑构造器结束时会隐式赋值。只修改参数即可把规范化结果传给字段，手写字段赋值反而不符合 record 规则。

应该先校验还是先 trim

先处理 null，再做不会改变语义的规范化，最后校验规范化后的结果。这样全是空格的输入会按空字符串拒绝，而不会绕过非空检查。

规范化会不会破坏 record 的不可变性

不会。构造阶段允许改变隐式参数，构造结束后组件字段仍是 final；外部只能通过 accessor 读取已经确定的值。