Java 16 Record 简化 DTO 开发指南

Java 16 引入的 record 类专为简化 DTO 开发而生，以极简语法（如 `public record User(String name, int age, String email) {}`）自动实现不可变数据结构所需的所有样板代码——包括 final 字段、全参构造器、无 get 前缀的访问器、以及完善的 `equals`/`hashCode`/`toString`，轻松削减约 80% 的冗余代码；它强制纯数据契约、禁止继承与行为逻辑，配合紧凑构造器支持轻量校验，但需注意 JSON 序列化兼容性、接口显式实现及与 Lombok 等工具的互斥性——当你需要的只是一个清晰、安全、零 boilerplate 的数据载体时，record 就是 Java 中最优雅且生产力爆表的选择。

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、只负责对已生成的隐式字段做运行时检查或调整：

• 校验示例：防止 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 16 Record 简化 DTO 开发指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！