Java record 自定义构造器与紧凑构造器的写法区别

冷炫風刃

冷炫風刃

2026-03-22

773人浏览

原创

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

java record 自定义构造器与紧凑构造器的写法区别

Java record 的构造器不能像普通类那样随意重载或自定义,但可以通过“紧凑构造器”(compact constructor)实现初始化逻辑的定制,它和传统构造器在语法、用途和限制上都有本质区别。

紧凑构造器:只能有一个,且不能有参数列表

record 的紧凑构造器写法是省略参数的,形式为 RecordName() { ... }。它会在 record 自动生成的全参构造器执行之后、对象返回之前被调用,用于对已赋值的组件字段做校验、转换或归一化处理。

  • 不声明参数,也不能访问未初始化的字段(因为字段此时已由底层构造器设好)
  • 不能用 this(...) 调用其他构造器(record 不允许构造器链)
  • 不能返回值,不能修饰为 privatepublic(默认就是 public)
  • 常见用途:校验非空、规范化字符串、约束数值范围

例如:

Java JDK 25
Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。

下载
record Person(String name, int age) {
  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.namethis.age 已经是传入值,任何重新赋值(如 this.name = this.name.trim())在语法上虽允许,但实际无效(final 字段无法二次赋值),编译会报错。

  • 如果真需要规范化(比如存 trimmed name),应在工厂方法里处理好再传入
  • 紧凑构造器适合抛异常、打日志、计算派生值(不改变 record 字段)等副作用操作

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

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

2023.06.15

3865

6

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

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

2023.07.05

2839

9

java自学难吗
java自学难吗

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

2023.07.31

2878

8

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

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

2023.08.01

637

3

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

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

2023.08.02

602

3

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

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

2023.08.02

726

5

java有什么用
java有什么用

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

2023.08.02

1317

5

java在线网站
java在线网站

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

2023.08.03

18845

3

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

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

647

8

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

Java 26官方文档
Java 26官方文档

共0课时 | 0人学习