[Java] Java 关键字 `record`:不可变数据载体类型 [JDK16-]
0 序
- 最近从 JDK 8 切换到 JDK 17,看到部分模块中大量使用了 record 关键字。为此有必要了解一二。
1 概述:Java 关键字 record
总体概括
record是 Java 16 正式定稿(JEP 395)的一种【不可变数据载体类型】:写一行类声明,【编译器】就自动给你补上【构造器】、【访问器】、equals/hashCode/toString,专治“【只有字段没有行为的 DTO / 值对象】”这类【样板代码】。
public record Point(int x, int y) { }
Point p = new Point(1, 2);
p.x(); // 访问器是 x(),不是 getX()
【编译器】自动生成的四类成员
| 生成物 | 具体形态 | 说明 |
|---|---|---|
| 规范构造器 | Point(int x, int y) |
参数即全部组件,字段由它写入 |
| 访问器/访问方法 | x() / y() |
无 get 前缀,与字段同名 |
equals |
逐组件比较 | 值语义,两个 Point(1,2) 相等 |
hashCode / toString |
基于全部组件 | toString 形如 Point[x=1, y=2] |
对应【字段/属性】是
private final,所以天然不可变、线程安全可共享。
硬性规则(容易被面试问到)
record隐式为final:不能【被继承】,也不能 【extends】 任何类(但可以实现接口)。- 【成员】只能是组件列表,不允许再声明额外的【实例字段】。
- 允许有:静态字段、静态方法、自定义实例方法、紧凑构造器。
- 嵌套 record 隐式
static;Java 16 起还支持局部 record(定义在方法体内,适合临时的中间聚合结构)。 - 不是 Java Bean:没有【无参构造】、没有 setter,
java.beans/ 依赖 setter 的老框架会不认它。
紧凑构造器:校验与规范化
public record Range(int lo, int hi) {
public Range { // 不写参数列表
if (lo > hi) throw new IllegalArgumentException("lo > hi");
lo = Math.max(lo, 0); // 可对参数做规范化,再自动赋值给字段
}
}
需要“派生值”时用普通(非紧凑)构造器委托:public Range(int hi) { this(0, hi); }。
与【模式匹配】配合(作为其最大的价值之一)
// instanceof 模式(Java 16)
if (obj instanceof Point(int x, int y)) { ... }
// switch 模式(Java 21,记录模式解构)
String s = switch (shape) {
case Point(int x, int y) when x > 0 -> "first quadrant";
case Point(int x, int y) -> "somewhere";
default -> "other";
};
- 【记录模式】把
record变成可解构的数据形状,写 sealed 接口 + record 组合就得到一个【代数数据类型风格的封闭模型】,非常适合【规则引擎】、【AST】、【事件消息】这类场景。
什么时候该用 / 不该用
| 适合 | 不适合 |
|---|---|
| DTO、API 出入参、配置快照 | JPA/MyBatis 实体(通常要无参构造 + setter) |
| 值对象(金额、坐标、时间段) | 需要可变状态、需要增量更新的对象 |
方法多返回值(替代 Map/Object[]) |
有大量派生状态需缓存的场景(无字段可放) |
Map 的复合 key、Set 元素 |
需要继承层次建模的领域类 |
sealed + 模式匹配的封闭模型 |
需要懒加载代理的框架对象 |
几个实操细节
- 序列化:record 走基于组件的规范序列化,
readObject/writeObject之类钩子无效;反序列化只走规范构造器,所以构造器里的校验一定生效。 - 反射:
Class.isRecord()+getRecordComponents()拿RecordComponent[],是做通用序列化/映射时的新入口。 - 和 Lombok 的分工:
@Value能给你更多自由度(可变字段、自定义 equals),但 record 是语言级、无注解处理器依赖、且能被模式匹配解构。新项目里纯数据载体优先 record。 - 注意:组件若是可变引用(数组、
List),record 只保证“引用不变”,不保证内容不变——要防御性拷贝就在紧凑构造器里做。
选型口诀:“这个类是不是只在描述一组值的组合,并且创建后不该再变?”是 → record,否 → 普通类。
2 案例实践
CASE OntologyObject Record
- JDK 17
OntologyObject
import java.util.Map;
/**
* 一个本体对象。
*
* @param objectType 对象类型名
* @param primaryKey 主键,在同一 objectType 内唯一
* @param properties 属性键值,只包含请求 select 的列
*/
public record OntologyObject(
String objectType,
String primaryKey,
Map<String, Object> properties
) {}
OntologyObjectTest
import lombok.extern.slf4j.Slf4j;
import org.junit.Test;
import java.util.Map;
/**
* 测试验证
* @version v1.0.0
* @description
* @create-time 2026/11/11 11:35
* @update-time
*
*/
@Slf4j
public class OntologyObjectTest {
/**
* 测试 jdk record 关键字
*/
@Test
public void testJdkRecord(){
OntologyObject ontologyObject = new OntologyObject("Vehicle", "vin", Map.of("vin", "1234567890", "brand", "BMW" ));
log.info("ontologyObject: {}", ontologyObject);//ontologyObject: OntologyObject[objectType=Vehicle, primaryKey=vin, properties={brand=BMW, vin=1234567890}]
}
}
Y 推荐文献
X 参考文献
本文作者:
千千寰宇
本文链接: https://www.cnblogs.com/johnnyzen
关于博文:评论和私信会在第一时间回复,或直接私信我。
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
日常交流:大数据与软件开发-QQ交流群: 774386015 【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!
本文链接: https://www.cnblogs.com/johnnyzen
关于博文:评论和私信会在第一时间回复,或直接私信我。
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!
日常交流:大数据与软件开发-QQ交流群: 774386015 【入群二维码】参见左下角。您的支持、鼓励是博主技术写作的重要动力!

浙公网安备 33010602011771号