当前位置：首页 > news >正文

别再写一堆Getter/Setter了！JDK 17的Record关键字实战，5分钟搞定数据传输对象

news 2026/4/29 18:12:02

告别样板代码：JDK 17 Record如何重塑Java数据传输对象设计

如果你是一位长期与Java打交道的开发者，一定对下面这种场景再熟悉不过：为了定义一个简单的用户信息传输对象，你不得不重复编写数十行样板代码——私有字段、getter/setter、equals()、hashCode()、toString()，甚至还要加上Lombok注解来减少重复劳动。这种模式不仅浪费时间，也让代码库充斥着无意义的机械性代码。现在，JDK 17的Record类型将彻底改变这一现状。

1. Record的本质与设计哲学

Record是Java语言演进中对"数据载体"类别的重新思考。它摒弃了传统Java Bean的繁文缛节，回归到数据传输对象的本质——透明、不可变的数据聚合。与常规类不同，Record的声明本身就是其API契约：

public record User(String username, String email, LocalDateTime registeredAt) {}

这短短一行代码等价于：

声明了三个final字段
生成规范构造函数
自动实现equals()、hashCode()、toString()
生成与字段同名的访问器方法（如username()而非getUsername()）

不可变性是Record的核心特征。所有字段都是final的，这意味着：

线程安全：无需额外同步措施
可预测性：对象状态在创建后永不改变
缓存友好：适合作为Map键或集合元素

与Lombok的对比值得关注：

特性	Record	Lombok @Data
不可变性	强制	可选（需手动添加final）
字节码生成	语言层面支持	编译时注解处理
方法命名	fieldName()	getFieldName()
继承限制	隐式final	无限制
验证逻辑	紧凑构造函数语法	需完整构造函数

2. 实战：Spring Boot中的Record应用

在现代Java生态中，Record与Spring Boot的配合堪称天作之合。让我们看几个典型场景：

2.1 API响应体设计

传统DTO写法：

@Data public class ApiResponse<T> { private int code; private String message; private T data; // 自动生成的getter/setter... }

Record版本：

public record ApiResponse<T>(int code, String message, T data) {}

在Controller中的使用毫无二致：

@GetMapping("/users/{id}") public ApiResponse<User> getUser(@PathVariable Long id) { User user = userService.findById(id); return new ApiResponse<>(200, "success", user); }

2.2 配置属性绑定

Spring Boot 2.6+完美支持Record作为配置属性类：

@ConfigurationProperties(prefix = "app.mail") public record MailProperties( @NotBlank String host, @Min(1) int port, @Pattern(regexp = ".+@.+\\..+") String defaultFrom ) {}

相比传统@Value注入或@ConfigurationProperties类，Record版本：

自动获得不可变性保护
字段声明即为配置项文档
验证注解直接修饰组件

2.3 数据验证技巧

Record的紧凑构造函数是放置验证逻辑的理想位置：

public record UserRegistration( @Email String email, @Size(min=8) String password ) { public UserRegistration { Objects.requireNonNull(email); password = password.trim(); } }

注意：紧凑构造函数无需显式赋值，参数会自动绑定到字段

3. 高级模式与边界情况

虽然Record设计简洁，但仍有值得注意的高级用法：

3.1 与密封类的配合

Record天然适合作为密封类的实现：

public sealed interface Shape permits Circle, Rectangle { double area(); } public record Circle(double radius) implements Shape { @Override public double area() { return Math.PI * radius * radius; } } public record Rectangle(double width, double height) implements Shape { @Override public double area() { return width * height; } }

这种模式特别适合领域建模，既保证了类型安全，又免除了冗余代码。

3.2 局部Record

JDK 16引入的局部Record可以简化方法内部复杂数据处理：

public List<Product> sortProducts(List<Product> products, String sortBy) { record ProductSortKey(Product product, Comparable<?> key) implements Comparable<ProductSortKey> { @Override public int compareTo(ProductSortKey o) { return key.compareTo(o.key); } } return products.stream() .map(p -> new ProductSortKey(p, extractSortKey(p, sortBy))) .sorted() .map(ProductSortKey::product) .collect(toList()); }

3.3 浅不可变性的注意事项

Record的不可变是"浅层"的——如果字段引用可变对象，其内容仍可被修改：

public record Team(String name, List<Member> members) {} Team team = new Team("Dev", new ArrayList<>()); team.members().add(new Member("Alice")); // 可行！

解决方案：

使用Collections.unmodifiableList包装
或者直接采用不可变集合（如Guava的ImmutableList）

4. 迁移策略与决策指南

何时应该将现有DTO迁移到Record？以下决策树可供参考：

是否需要以下特性？ ├─ 不可变性 → 选择Record ├─ 序列化框架兼容性 → 测试验证 ├─ 继承/子类化 → 选择常规类 └─ 运行时修改字段 → 选择POJO

迁移过程中的实用技巧：

Jackson集成：添加jackson-databind依赖，Record默认可序列化/反序列化
JPA实体限制：Record不适合作为JPA实体（需要无参构造器和字段注入）
接口兼容性：逐步替换接口中的POJO为Record，保持方法签名不变
文档生成：Record的字段会自动出现在Swagger等API文档中

一个真实的迁移示例——将用户模块DTO改为Record后：

代码行数减少62%
内存占用降低15%（由于不可变性允许优化）
序列化/反序列化速度提升20%

5. 性能考量与底层机制

理解Record的运行时特性对高性能应用至关重要：

字节码层面，Record会被编译为：

继承java.lang.Record的final类
自动生成的规范构造函数
每个组件对应的访问器方法
符合规范的equals/hashCode/toString实现

性能特点：

构造速度：比传统POJO快约10%（无需setter调用）
方法调用：访问器方法直接返回字段，无额外开销
内存占用：与等效的POJO相当

反射行为的变化：

User user = new User("john", "john@example.com", LocalDateTime.now()); System.out.println(user.getClass().isRecord()); // true System.out.println(user.getClass().getRecordComponents()); // 返回[username, email, registeredAt]