record 类是 java 16 为 dto 场景设计的不可变扁平数据载体,自动生成字段、构造器、getter、equals、hashcode 和 tostring;组件名即访问器名(无 get 前缀);仅支持紧凑构造器校验,不支持继承。

Record 类在 Java 16 中就是为这类 DTO 场景量身定制的:只要数据不可变、结构扁平、只承载字段和基础访问逻辑,用 record 替代 class 能直接砍掉 80% 的样板代码(private final 字段、构造器、getter、equals、hashCode、toString 全部自动生成)。
record 声明语法和字段语义必须对齐 DTO 需求
声明一个 record 就是声明一组命名、类型明确的组件(components),它们默认是 final 且通过隐式公共 getter 暴露。不能有显式字段声明,所有状态必须出现在 record 头部括号中:
public record User(String name, int age, String email) {}
这行代码等价于手写一个含三个 private final 字段、一个全参构造器、三个 name()/age()/email() 方法、以及重写的 equals/hashCode/toString 的类。注意:name() 不是 getName() —— record 的访问器方法名直接取组件名,无 get 前缀,这是强制约定,别试图改名或加 get。
需要校验或默认值时,必须用紧凑构造器(compact constructor)
record 不允许定义普通构造器,但支持“紧凑构造器”——它没有参数列表、不写 return、只负责对已生成的隐式字段做运行时检查或调整:
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 校验示例:防止
email为空
public record User(String name, int age, String email) {
public User {
if (email == null || email.isBlank()) {
throw new IllegalArgumentException("email cannot be blank");
}
}
}
注意:紧凑构造器里不能给字段赋值(如 this.email = email.trim() 是非法的),只能读取或抛异常;若需归一化(如 trim),得用规范构造器(canonical constructor),即显式写出带参数的构造器并调用 this(...),但会失去部分自动生成优势,慎用。
record 不支持继承、不能被继承,且序列化/反序列化需额外注意
record 是 final 类,不能 extends 其他类,也不能被其他类 extends。这对 DTO 是好事(避免意外多态破坏不可变性),但带来两个现实问题:
- JSON 库(如 Jackson)默认能识别 record 组件,但旧版本(ParameterNamesModule
- 若 DTO 需实现接口(如
Serializable),必须显式声明:public record User(...) implements Serializable;否则即使字段都可序列化,record 本身也不自动实现该接口 - Lombok 的
@Data等注解与 record 冲突,混用会导致编译失败,删掉 Lombok 依赖更干净
record 的简洁性建立在“纯数据+无行为”的契约上;一旦你发现自己在 record 里加 if 分支逻辑、缓存计算结果、或依赖外部服务,就该立刻停下来——那已经不是 DTO,而是该用普通 class 承载业务含义了。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










