讲师中心 微信公众号
AI工具推荐 视频效率加速

怎么利用 Record 在 JDK 17 之后定义不可变 DTO 并自动获得编译器优化的序列化能力

老丽姑娘_9194

老丽姑娘_9194

发布时间:2026-04-23 15:36:27

|

223人浏览过

|

来源于php中文网

原创

Record本身不提供自动序列化能力,真正起作用的是JSON库(如Jackson 2.12+已原生支持),但需满足三个前提:组件名与JSON字段名一致、无自定义规范构造器、字段类型为Jackson默认支持类型。

怎么利用 record 在 jdk 17 之后定义不可变 dto 并自动获得编译器优化的序列化能力

Record 类本身不提供“自动序列化能力”,它只是让 DTO 更安全、更简洁;真正起作用的是你用的 JSON 库(比如 Jackson)是否支持 Record 的无参构造器和访问器方法——而从 Jackson 2.12+ 开始,它已经原生支持 record 的序列化/反序列化,无需额外注解或配置。

Record 定义 DTO 时必须满足的三个结构前提

不是所有 record 都能被 Jackson 无缝序列化。关键看编译后生成的字节码是否符合库的反射预期:

  • record 的组件名(如 username)必须与 JSON 字段名一致,否则需加 @JsonProperty 显式绑定
  • 不能有自定义的规范构造器(canonical constructor)且未显式调用 super(...) —— 否则 Jackson 可能因找不到匹配构造器而报 InvalidDefinitionException: Cannot construct instance
  • 字段类型需是 Jackson 默认支持的(如 String、Integer、LocalDateTime 等),若含自定义类型(如 Money),仍需注册模块或提供 JsonSerializer/JsonDeserializer

Jackson 2.14+ 下零配置序列化示例

以下 UserDTO 在 Jackson 2.14+(对应 JDK 17+ 运行环境)中可直接用于 ObjectMapper.readValue() 和 writeValueAsString():

public record UserDTO(String username, Integer age, LocalDateTime createdAt) {}

使用时:

ObjectMapper mapper = new ObjectMapper();
String json = """{"username":"alice","age":28,"createdAt":"2026-04-20T10:30:00"}""";
UserDTO dto = mapper.readValue(json, UserDTO.class); // ✅ 成功
System.out.println(dto.username()); // "alice"

注意:如果 createdAt 是 String 类型而非 LocalDateTime,Jackson 会反序列化失败,除非你注册了 JavaTimeModule。

容易踩的坑:泛型 Record + List 字段的反序列化失败

这是高频翻车点。Record 声明中带泛型类型参数(如 List<string></string>)本身没问题,但 Jackson 默认无法推断泛型擦除后的实际类型:

  • 错误写法:public record OrderDTO(String id, List<string> items) {}</string> → 反序列化时 items 可能变成 LinkedHashMap 而非 ArrayList<string></string>
  • 正确写法:用 TypeReference 显式指定类型:mapper.readValue(json, new TypeReference<orderdto>() {})</orderdto>,或在字段上加 @JsonCreator + @JsonProperty 注解引导构造器参数绑定
  • 更稳妥做法:对复杂嵌套结构,优先用接口 + default 方法封装构造逻辑,避免依赖 Jackson 对 record 构造器的自动推导

真正影响性能的不是 Record 本身,而是你在反序列化时是否触发了不必要的 toString() 或 hashCode() 计算(比如把 Record 放进 HashSet 后又频繁修改字段——但 Record 字段是 final 的,所以这一步根本不会发生)。重点其实是:别在 record 里塞大对象(如 byte[] 或长文本 String),因为 hashCode() 会遍历全部内容,可能拖慢集合操作。

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

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
java
java

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

11777

2023.06.15

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

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

8882

2023.07.05

java自学难吗
java自学难吗

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

7612

2023.07.31

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

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

1244

2023.08.01

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

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

1008

2023.08.02

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

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

1496

2023.08.02

java有什么用
java有什么用

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

3089

2023.08.02

java在线网站
java在线网站

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

20351

2023.08.03

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

0

2026.11.02

热门下载

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

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn