java record 的紧凑构造器是唯一允许的构造器定制方式,形式为 recordname() { ... },在字段初始化后执行,用于校验或归一化,不可重载、无参数、不能调用其他构造器,且字段为 final 不可修改。

Java record 的构造器不能像普通类那样随意重载或自定义,但可以通过“紧凑构造器”(compact constructor)实现初始化逻辑的定制,它和传统构造器在语法、用途和限制上都有本质区别。
紧凑构造器:只能有一个,且不能有参数列表
record 的紧凑构造器写法是省略参数的,形式为 RecordName() { ... }。它会在 record 自动生成的全参构造器执行之后、对象返回之前被调用,用于对已赋值的组件字段做校验、转换或归一化处理。
- 不声明参数,也不能访问未初始化的字段(因为字段此时已由底层构造器设好)
- 不能用 this(...) 调用其他构造器(record 不允许构造器链)
- 不能返回值,不能修饰为 private 或 public(默认就是 public)
- 常见用途:校验非空、规范化字符串、约束数值范围
例如:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
Person() {
if (name == null || name.trim().isEmpty()) throw new IllegalArgumentException("name cannot be blank");
if (age 150) throw new IllegalArgumentException("age out of valid range");
}
}
不能写传统意义上的“自定义构造器”
record 不允许显式定义带参数的构造器(如 Person(String name)),否则编译报错。这是为了保证 record 的不可变性和语义一致性——它的状态必须完全由组件字段定义,且所有实例都应通过同一套完整参数构建。
- 试图添加额外构造器会导致 “error: invalid compact constructor declaration” 或 “constructor is not allowed in record”
- 若需要多种创建方式(如只传 name,默认 age=0),应使用静态工厂方法替代
推荐做法:
record Person(String name, int age) {Person() { /* 紧凑构造器 */ }
public static Person of(String name) {
return new Person(name, 0);
}
public static Person adult(String name) {
return new Person(name, 18);
}
}
紧凑构造器 vs 普通类构造器的关键差异
- 执行时机不同:紧凑构造器在字段赋值之后运行;普通类构造器中字段尚未赋值,需手动 this.field = param
- 职责不同:紧凑构造器只做验证/调整,不能修改字段值本身(虽然可以,但违背 record 设计初衷,且不会影响最终状态——因为字段是 final 的)
- 可读性更强:逻辑集中,避免重复校验代码散落在多个构造器中
注意:字段赋值发生在紧凑构造器之前,不可绕过
record 实例化时,JVM 先用传入参数完成所有 final 字段的初始化,再调用紧凑构造器。这意味着你在紧凑构造器里看到的 this.name 和 this.age 已经是传入值,任何重新赋值(如 this.name = this.name.trim())在语法上虽允许,但实际无效(final 字段无法二次赋值),编译会报错。
- 如果真需要规范化(比如存 trimmed name),应在工厂方法里处理好再传入
- 紧凑构造器适合抛异常、打日志、计算派生值(不改变 record 字段)等副作用操作
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










