如何利用 Record 记录类简化 DTO 对象的定义并减少模板代码

千明吖_5715

千明吖_5715

2026-04-14

439人浏览

原创

Record类在DTO场景的核心价值是:以一行声明自动实现不可变数据载体所需的所有模板代码,包括final字段、getter、equals/hashCode/toString,语义清晰且字节码精简。

如何利用 record 记录类简化 dto 对象的定义并减少模板代码

Record 类在 DTO 场景下的核心价值是什么 Java 14 引入的 record 是为不可变数据载体量身定制的语法糖。它天然适合 DTO(Data Transfer Object)——这类对象通常只承载字段、提供 getter、支持 equals/hashCode/toString,不包含业务逻辑。用 record 替代传统 class 定义 DTO,能直接省掉构造器、getter、equals()、hashCode()、toString() 的手写代码,且编译后字节码更精简。

关键判断:如果你的 DTO 满足「只读 + 字段即状态 + 无行为」,record 就是更优解;一旦需要 setter、字段校验逻辑、延迟计算或继承,就得退回到普通 class。

如何正确定义一个带验证的 Record DTO record 本身禁止字段赋值,但允许在构造器中做参数校验。不能写 setter,但可以在 compact constructor 中抛异常或规范化输入。

常见错误现象:直接在 record 声明里调用 Objects.requireNonNull() 或做 trim,结果编译失败 —— 因为 record 的隐式构造器不允许语句块外的逻辑。

  • 必须使用 compact constructor(即与 record 同名、无返回值、无修饰符的构造器)来插入校验逻辑
  • 校验失败应抛 IllegalArgumentException,而非自定义异常(避免破坏 record 的不可变契约)
  • 不要在 compact constructor 中修改参数引用(如 name = name.trim()),这会改变入参,且违反 record 设计意图;如需标准化,应新建局部变量并用于字段初始化
record UserDTO(String name, Integer age) {
    public UserDTO {
        if (name == null || name.trim().isEmpty()) {
            throw new IllegalArgumentException("name cannot be blank");
        }
        if (age == null || age  150) {
            throw new IllegalArgumentException("age must be between 0 and 150");
        }
    }
}

Record DTO 与 Jackson / Lombok 兼容性要注意什么 Spring Boot 2.6+ 和 Jackson 2.12+ 原生支持 record,但仍有几个易踩的坑:

使用场景:Web 层接收 JSON 请求体(@RequestBody)、响应序列化(@ResponseBody)时,默认能正常工作;但若 DTO 字段名与 JSON key 不一致,或需忽略 null 字段,配置方式和 class 略有不同。

  • @JsonProperty 可加在 record 参数上(不是字段),例如 record UserDTO(@JsonProperty("user_name") String name, ...)
  • @JsonIgnore 加在参数上可忽略该字段反序列化/序列化
  • Lombok 的 @Data、@Builder 与 record 冲突,不能混用;若需 Builder 模式,可用 record + 静态工厂方法,或改用 Builder record(较重,一般不推荐)
  • Spring Validation(如 @NotBlank)需配合 @Valid 使用,且注解必须加在 record 参数上,而非 getter(因为没有 getter 方法)

什么时候不该用 Record 定义 DTO 不是所有“看起来像 DTO”的类都适合 record。容易被忽略的边界情况包括:

性能影响:record 所有字段默认 public final,反射访问开销略低于普通 class 的 getter(尤其在高频序列化场景),但这点差异通常可忽略;真正影响大的是语义误用。

  • 字段需要运行时动态计算(如 getFullName())—— record 不允许定义非字段相关方法(除非是静态或私有辅助方法)
  • DTO 需要实现接口(如 Serializable 以外的业务接口)—— record 只能 implements 接口,但无法 override 接口中的 default 方法来改变行为
  • 字段类型含泛型通配符(如 List extends Number>)—— record 构造器参数签名不支持通配符,会导致编译失败
  • 需要与旧版 JDK(

最常被低估的一点:record 的不可变性是语言级保证,一旦 DTO 在后续迭代中出现“这个字段其实应该能改”的需求,重构成本远高于从 class 开始设计。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11357

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8462

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7292

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1456

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2989

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20251

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1315

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习