紧凑构造方法是记录类中唯一允许在字段赋值前执行校验与参数归一化的位置，用于非空、范围、格式检查等，可修改参数值但不可直接赋值字段。
Java 记录类（record）的紧凑构造方法（compact constructor）是唯一允许在字段赋值前执行自定义逻辑的地方，也是做前置校验（如非空、范围检查、格式验证等）的**标准且推荐位置**。它在隐式调用默认构造函数之后、字段赋值之前执行，因此可以安全访问参数，也能修改参数值（影响后续字段赋值），但不能直接给记录字段赋值（字段由 JVM 自动赋值）。
紧凑构造方法的基本写法与校验时机
紧凑构造方法没有修饰符、返回类型和显式参数列表（参数名和类型由记录头自动推导），其主体在 `{}` 中。它会在字段初始化前运行，此时可对入参做任意校验或规范化操作：
- 校验失败应抛出异常（如
NullPointerException、IllegalArgumentException），否则记录实例可能处于非法状态 - 可对参数做“归一化”处理（如 trim 字符串、转小写、取绝对值），这些修改会作用于后续字段赋值
- 不能写
this.name = name;这类赋值语句——编译器会报错，因为字段赋值由 JVM 隐式完成
常见校验场景与写法示例
以下是一个含多种校验的记录类示例：
public record User(String name, int age, String email) {
public User {
// 1. 非空校验
if (name == null || name.trim().isEmpty()) {
throw new IllegalArgumentException("name must not be null or blank");
}
// 2. 范围校验
if (age < 0 || age > 150) {
throw new IllegalArgumentException("age must be between 0 and 150");
}
// 3. 格式校验（简单邮箱）
if (email == null || !email.matches("^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$")) {
throw new IllegalArgumentException("email format is invalid");
}
// 4. 归一化：去除首尾空格，转小写（影响最终字段值）
name = name.trim();
email = email.toLowerCase().trim();
}
}
注意：最后两行的 name = ... 和 email = ... 是合法的——它们修改的是**参数变量本身**，JVM 在紧凑构造方法结束后，会把修改后的参数值赋给对应字段。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
立即学习“Java免费学习笔记（深入）”；
与普通构造方法的区别与限制
紧凑构造方法不是普通构造方法的替代品，它有明确边界：
- 一个记录类最多只能有一个紧凑构造方法；不可重载
- 不能调用
this(...)或super(...)；无显式父类可继承 - 不能声明 throws 子句（但可抛出运行时异常）
- 若不定义紧凑构造方法，编译器会生成一个空的默认版本（相当于
public User { }） - 字段的 final 性质不受影响——校验通过后，JVM 仍以不可变方式完成赋值
调试与测试建议
由于紧凑构造方法逻辑直接影响实例创建成败，建议：
- 为每条校验分支编写单元测试，覆盖正常值、边界值、非法值（如 null、负数、超长字符串）
- 使用 IDE 调试时，在紧凑构造方法内设断点，观察参数值和异常抛出点
- 避免在其中做耗时操作（如 I/O、网络请求），保持轻量，符合记录类“不可变数据载体”的设计初衷
