Java 14 引入 record 预览特性,Java 16 正式转正,专为不可变数据载体设计,自动生成构造器、accessor、equals、hashCode 和 toString;支持静态/实例方法扩展但禁止可变字段和重写 accessor;适用于 DTO、VO 等场景,不适用于需继承或频繁修改的对象。

Java 14 引入 record 作为预览特性,Java 16 正式将其转正——它专为“不可变数据载体”而生,省去手写构造器、getter、equals、hashCode 和 toString 的重复劳动。用好它,几行代码就能定义一个语义清晰、安全可靠的纯数据类。
一、基本语法:一行声明,自动补全所有样板代码
只需用 record 关键字 + 类名 + 括号内声明字段(含类型和名称),编译器自动生成:
public record Person(String name, int age) {}
等价于你手动写了:
- 一个 public final 的私有字段(
name,age) - 一个公共全参构造器(参数顺序与声明一致)
- 每个字段对应的public accessor 方法(如
name()和age(),无get前缀) - 重写的
equals、hashCode(基于所有组件值) - 重写的
toString(格式为Person[name=xxx, age=yyy])
二、自定义行为:允许添加方法,但不能破坏不可变性
record 允许你添加静态方法、实例方法、甚至私有辅助方法,但不能声明可变字段(即不能加 private String nickname; 这类普通字段),也不能重写 accessor(如不能写 public String name() { return name.toUpperCase(); },会编译报错)。
立即学习“Java免费学习笔记(深入)”;
常见合理扩展方式:
- 添加静态工厂方法:
public static Person of(String name, int age) { return new Person(name, age); } - 添加实例校验逻辑(在紧凑构造器中):
public Person { if (age - 添加便捷计算方法:
public boolean isAdult() { return age >= 18; }
三、使用注意:它不是万能 DTO,适用场景很明确
record 的设计目标是“透明的、不可变的数据聚合”,因此适合以下场景:
- DTO(数据传输对象)、VO(视图对象)、返回值封装(如
Map.Entry的替代) - 函数式编程中的元组或中间结果(如
record Result<t>(boolean success, T data, String error)</t>) - 枚举配套的结构化数据(如
enum Status { OK(200), ERROR(500); private final int code; ... }可搭配record StatusInfo(Status status, String message))
不适合:
- 需要继承、实现复杂业务逻辑的实体类
- 需频繁修改字段值的对象(record 字段默认 final,不支持 setter)
- 需要深度定制序列化/反序列化行为且框架不原生支持 record 的旧系统
四、配合其他 Java 16+ 特性更高效
record 天然适配一些现代 Java 实践:
-
模式匹配 for instanceof(Java 16 正式):可直接解构 record,如
if (obj instanceof Person(String n, int a)) { System.out.println(n + " is " + a); } -
Stream + record 构造器引用:如
list.stream().map(Person::new).toList()(若 list 是List<object></object>或自定义解析器返回 Object[]) - JSON 库(如 Jackson 2.12+、Gson 2.8.9+)已原生支持 record:无需额外注解即可序列化/反序列化
不复杂但容易忽略:record 不是语法糖,它是语言级契约——一旦声明,就承诺“这个类只承载数据、不可变、结构透明”。用对了,代码更轻、更安全、更易读。


















