Java 14 的 record 是专为不可变数据载体设计的轻量级类,自动实现 final 字段、全参构造器、accessor、equals/hashCode/toString,禁止继承与实例字段,适用于 DTO、VO 等只读场景。

Java 14 引入的 record 是专为不可变数据载体设计的轻量级类,能大幅减少样板代码(如构造器、getter、equals、hashCode、toString),让纯数据对象的定义变得直观、安全且简洁。
record 的核心语义:自动实现不可变数据结构
record 不是语法糖,而是有明确契约的语言特性。它隐含以下约定:
- 所有字段默认 public final,且只能通过构造器初始化
- 自动生成规范的 全参构造器(参数顺序与字段声明一致)
- 自动生成 getter 方法(无 get 前缀,直接用字段名,如
name()) - 自动生成基于所有组件字段的 equals/hashCode/toString
- 禁止继承(隐式 final)、不能声明实例字段(除
static或transient外)
基础用法:一行定义一个完整数据类
例如表示用户信息:
record User(String name, int age, String email) {}编译后等价于手写一个包含 3 个 final 字段、全参构造器、3 个 accessor(name()、age()、email())、以及重写的 equals/hashCode/toString 的类。
立即学习“Java免费学习笔记(深入)”;
使用方式自然简洁:
User u = new User("Alice", 30, "a@example.com");System.out.println(u.name()); // Alice
System.out.println(u); // User[name=Alice, age=30, email=a@example.com]
进阶技巧:定制行为而不破坏不可变性
record 允许添加静态方法、实例方法、私有辅助方法,甚至紧凑构造器(compact constructor)来校验或规范化输入:
record Person(String name, int age) {public Person {
if (name == null || name.trim().isEmpty())
throw new IllegalArgumentException("Name cannot be blank");
if (age 150)
throw new IllegalArgumentException("Invalid age");
}
public boolean isAdult() { return age >= 18; }
public static Person of(String name, int age) {
return new Person(name, age);
}
}
注意:紧凑构造器中不能给字段赋值(字段由 JVM 自动初始化),只能做校验或转换逻辑;若需修改值(如 trim name),应通过 `this(...)` 显式委托到规范构造器。
适用场景与注意事项
适合用 record 的情况:
- DTO、VO、API 响应体、数据库行映射(如 JPA Entity 的只读视图)
- 函数式编程中的元组或中间数据容器(如
record Pair<K,V>(K key, V value)) - 枚举伴随的数据结构(如
enum Status { OK(200), ERROR(500); private final int code; ... }可改用 record 封装状态码+消息)
不适合用 record 的情况:
- 需要可变状态(如计数器、缓存字段)
- 需深度继承体系或运行时多态行为(record 不能被 extends)
- 字段逻辑强耦合、需复杂封装(此时仍用普通 class 更清晰)


















