Java14记录类详解与使用方法

Java 14 引入的 record 并非普通类的语法糖，而是一种专为不可变数据载体设计的严谨语言特性：它强制声明至少一个组件字段、隐式 final 且不可继承，自动实现基于字段值的 equals/hashCode/toString，并通过编译器严格约束构造逻辑（如自定义构造器必须首行调用 canonical 构造器、禁止字段赋值、禁止重写核心行为）；同时警示开发者避免常见误用——如试图创建空 record 作标记、在字段中使用可变集合破坏不可变性、或强行模拟继承结构，真正理解 record 的“扁平、明确、不可扩展”哲学，才能安全高效地将其用于 DTO、返回值、配置项等纯数据场景。

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 默认行为完全不同。

容易踩的坑是把 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 共享字段），这条路走不通。替代方案只有两个：

• 用组合：让 AdminRecord 包含一个 UserRecord 字段
• 放弃 record，退回普通 class，自己手写 equals/hashCode（或用 Lombok @Data）
• Java 16+ 支持 sealed 类配合 record，但 record 本身仍不能作为父类

record 的设计哲学就是“扁平、明确、不可扩展”，想搞层次结构，它就不是合适工具。

以上就是《Java14记录类详解与使用方法》的详细内容，更多关于的资料请关注golang学习网公众号！