[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 参考文献

posted @ 2026-11-11 11:40  千千寰宇  阅读(9)  评论(0)    收藏  举报