Java 16下反射获取Record类构造器参数名异常的解决方案
问题背景
在Java 15、Java 16版本环境下,对自定义Record类型通过反射获取构造器参数名时,会出现自定义重载构造器无法读取真实参数名的偏差。
以如下定义的RecordTest2类为例:
public record RecordTest2(int id, int something, double total, LocalDateTime createdOn) { public RecordTest2(int id, int something, double total) { this(id, something, total, LocalDateTime.now()); } }
现象复现
使用如下反射代码遍历类中所有公开构造器,读取每个构造器的参数名:
var recordTest2 = new RecordTest2(1, 2, 3.0, LocalDateTime.now()); Class<?> objectClass = recordTest2.getClass(); Constructor<?>[] constructors = objectClass.getConstructors(); for (Constructor<?> con : constructors) { System.out.println(con.getName()); Parameter[] parameters = con.getParameters(); for (Parameter parameter : parameters) { System.out.printf("param: %s\n", parameter.getName()); } }
代码运行实际输出为:
net.sf.persism.dao.records.RecordTest2 param: arg0 param: arg1 param: arg2 net.sf.persism.dao.records.RecordTest2 param: id param: something param: total param: createdOn
可以观察到两个明确的表现差异:
- 和记录组件一一对应的全参规范构造器,可以正常读取到
id、something、total、createdOn等真实参数名 - 手动定义的三参重载构造器,反射读取到的参数名全部是
arg0、arg1、arg2这类占位值
现象根因
这个表现不是Record类型的反射机制缺陷,本质是Java类文件的参数名元数据写入规则差异:
- Record的规范构造器由编译器在生成类文件时自动关联记录组件生成,会强制将构造器参数名和记录组件名称绑定,写入类文件元数据属性,不受编译选项控制
- 手动编写的自定义重载构造器,和普通Java类的构造器规则完全一致:默认不会将真实参数名写入类文件,反射读取时就会返回
arg0这类占位名称
可行适配方案
目前有两种可落地的适配方式:
- 手动添加
@ConstructorProperties注解
给自定义构造器加上java.beans.ConstructorProperties注解,注解中传入的参数名数组需要和构造器的参数顺序完全一一对应,示例代码如下:
这种方式不依赖编译参数,哪怕类文件是在未开启参数名写入的环境下编译,只要带上这个注解,反射和Java内省机制都能正确读取到对应参数名。缺点是需要手动维护注解里的参数顺序,容易和实际构造器参数顺序错位。public record RecordTest2(int id, int something, double total, LocalDateTime createdOn) { @ConstructorProperties({"id", "something", "total"}) public RecordTest2(int id, int something, double total) { this(id, something, total, LocalDateTime.now()); } } - 编译环节开启
-parameters选项
执行javac编译时加上-parameters参数,编译器就会把所有方法、构造器的真实参数名写入类文件的元数据中。这时候不需要给每个自定义构造器加注解,反射就能直接读取到真实参数名,和普通类的反射表现完全一致。
这种方式不需要手动在代码中维护参数名映射,减少了冗余的代码标注成本,缺点是需要保证整个构建流程统一开启这个编译选项,一旦某个模块没有开启对应配置,对应的构造器还是会出现参数名读取为占位值的问题。
内容的提问来源于stack exchange,提问作者sproketboy
相关产品推荐
相关产品推荐

