如何在Java中定义和使用记录类(Record)_Java14数据载体新特性-java教程-PHP中文网

record 必须至少声明一个字段，不可继承或被继承，自动实现基于字段值的 equals/hashCode/toString，字段隐式 final，支持自定义构造器但须调用 canonical 构造器。

如何在java中定义和使用记录类(record)_java14数据载体新特性

Record 类必须有至少一个字段

Java 的 record 不是普通类的语法糖，它本质是不可变的数据载体，编译器会强制你声明至少一个组件字段。如果写成 record EmptyRecord {}，javac 直接报错：error: record must declare at least one component。

常见误用是想定义一个“标记型 record”来替代枚举或空接口，这行不通。真需要语义标记，用 enum 或 interface；真要空数据结构，老实用 class。

字段名不能是 final、static、transient 等修饰符（编译器自动加 final）
字段类型可以是任意引用或基本类型，但建议避开可变类型（如 ArrayList），否则破坏“不可变”契约
构造函数参数顺序和字段声明顺序严格一致，不能重排

自定义构造函数时必须调用 canonical 构造器

record 允许定义额外构造器，但所有自定义构造器第一行必须显式调用 this(...)，且参数必须能映射到 record 声明的字段。比如：

record Point(int x, int y) {
    public Point(int x) {
        this(x, 0); // ✅ 正确：转发给 canonical 构造器
    }
    public Point() {
        this(0, 0); // ✅ 同样合法
    }
}

如果漏掉 this(...) 或调用普通方法，编译失败：error: call to super() or this() must be first statement。

不能在自定义构造器里对字段赋值（this.x = ... 非法），字段由 canonical 构造器统一初始化
如果字段有校验逻辑（如非负），只能放在 canonical 构造器里，用 private 构造器 + this(...) 转发实现
IDE 自动生成的构造器补全通常不处理 record，别依赖它

record 的 equals/hashCode 是基于字段值，不是引用

record 自动重写 equals()、hashCode() 和 toString()，全部基于组件字段的值。这意味着两个不同实例只要字段值相同，equals 就返回 true —— 这和 String 行为一致，但和普通 class 默认行为完全不同。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

容易踩的坑是把 record 当作“轻量 class”随意修改字段，结果发现 Set 里存了重复项，或者作为 Map key 时行为异常。因为 record 字段是 final，你改不了；但如果你字段里存了可变对象（比如 List），外部修改这个 list，hashCode() 结果就可能变，违反哈希契约。

record 实例放进 HashSet 后，不要让它的任何字段指向的对象发生内容变更
字段类型优先选不可变类（String、LocalDate、其他 record），避免 ArrayList、HashMap
如果必须用可变集合，考虑在构造时做防御性拷贝：new ArrayList(inputList)

record 不能继承，也不能被继承

record 是 final 类，隐式 final，所以不能用 extends 继承其他类，也不能被其他类 extends。试图写 record A extends B 或 class C extends MyRecord，编译器直接拒绝：error: records are implicitly final and cannot extend other classes。

有人想用 record 模拟 DTO 继承结构（比如 UserRecord 和 AdminRecord 共享字段），这条路走不通。替代方案只有两个：