java 21 引入的 record 类通过自动实现 equals、hashcode、tostring 和访问器方法,将数据载体类的样板代码缩减至一行声明。开发者只需定义字段名和类型,jvm 会自动生成不可变实例及完整的契约逻辑,从而在保持封装性的同时极大简化了 dto 或配置对象的创建。

Record 如何自动生成核心方法
Record 编译器会依据声明的组件(components)自动生成私有 final 字段、全参构造函数以及对应的 getter 方法。这些 getter 方法去除了 get 前缀,直接以字段名命名。同时,编译器生成的 equals 和 hashCode 方法基于所有组件进行比较,确保值相等的两个实例被视为相等。这种机制消除了手动编写这些方法时容易出现的错误,如遗漏字段比较或使用错误的哈希算法。

public record Point(int x, int y) {
// 编译器自动生成:
// private final int x;
// private final int y;
// public Point(int x, int y) { this.x = x; this.y = y; }
// public int x() { return x; }
// public int y() { return y; }
// public boolean equals(Object o) { ... }
// public int hashCode() { ... }
// public String toString() { ... }
}
上述代码展示了最简化的 Record 定义。当实例化 new Point(1, 2) 时,生成的 equals 方法会检查对象类型及字段值。若创建另一个 new Point(1, 2),两者在逻辑上完全相等。这种自动生成的行为保证了数据载体的不可变性和一致性,无需开发者干预底层实现细节。
Record 如何处理自定义逻辑与验证
尽管 Record 默认生成标准方法,但允许开发者添加静态工厂方法、实例方法或紧凑构造函数(Compact Constructor)以注入自定义逻辑。紧凑构造函数在参数赋值给字段之前执行,常用于参数验证或规范化处理。这使得 Record 不仅能作为纯数据容器,还能在创建阶段保证数据的合法性,弥补了简单声明无法进行复杂校验的不足。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

public record User(String name, int age) {
public User {
if (name == null || name.isBlank()) {
throw new IllegalArgumentException("Name cannot be empty");
}
if (age <p>在 <code>User</code> Record 中,紧凑构造函数 <code>public User { ... }</code> 接收所有参数并在赋值前进行验证。如果传入空名称或负数年龄,构造过程将抛出异常,阻止非法状态的对象创建。这种设计模式结合了 Record 的简洁性与传统类的验证能力,确保了业务规则在数据入口处的严格执行。</p><h2>Record 在嵌套数据结构中的表现</h2><p>当 Record 包含其他 Record 或复杂对象作为组件时,其生成的 <code>equals</code> 和 <code>hashCode</code> 方法会递归调用内部组件的相应方法。这意味着嵌套结构也能正确地进行深度比较。例如,一个包含 <code>Address</code> Record 的 <code>Person</code> Record,其相等性判断不仅比较姓名,还会深入比较地址的各个字段。这种递归行为保持了数据层级的一致性,避免了浅层比较导致的逻辑错误。</p><pre class="brush:php;toolbar:false;">public record Address(String city, String zip) {}
public record Person(String name, Address address) {}
// 测试示例
var addr1 = new Address("Beijing", "100000");
var addr2 = new Address("Beijing", "100000");
var p1 = new Person("Alice", addr1);
var p2 = new Person("Alice", addr2);
System.out.println(p1.equals(p2)); // 输出 true
上述代码中,尽管 addr1 和 addr2 是不同的对象引用,但由于它们的字段值相同且 Address 是 Record,p1.equals(p2) 返回 true。这证明了 Record 在处理嵌套数据时能够正确传递相等性语义。开发者无需为嵌套对象单独编写比较逻辑,系统自动处理了深层结构的匹配,简化了复杂数据模型的构建与维护。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










