java反射获取方法参数名的几种方式总结

 更新时间:2025年02月24日 10:01:17   作者:笨猪大难临头  
这篇文章主要介绍了如何通过添加编译参数或使用Spring的工具类来获取方法参数名,还总结了不同版本的JDK和Spring项目中参数名获取的优缺点,并提供了应用场景举例,需要的朋友可以参考下

1、前言

一般当我们用类似下面的反射去获取方法参数名时得到的一般是 arg0、arg1, 参数名默认会丢失, 导致无法获取到真实的方法参数名,下面介绍如何通过其他方式解决。

    class A {
        void getUser(String userName, String userId){}
    }
    
    Method method = A.class.getMethod(String.class,String.class);
    Parameter[] parameters = method.getParameters();
    for (Parameter parameter : parameters) {
        String name = parameter.getName();
        System.out.println(name); // 得到的是arg0, arg1 而非 userName、userId
    }

2、解决方式

方式2.1: 添加编译参数配置 -parameters

java默认在编译工程代码为class文件时,会将方法参数名擦除,替换成arg0、arg1之类。但是我们可以在编译时配置将参数名也一并编译进去,在maven中新增如下编译插件配置

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <!-- 配置编译时将方法参数名保留 -->
                    <compilerArgs>
                        <arg>-parameters</arg>
                    </compilerArgs>
                </configuration>
            </plugin>

对于较新的 maven 版本(>= 3.6.2), 也可以直接使用 parameters 配置项:

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <parameters>true</parameters>
    </configuration>
</plugin>

添加-parameters的编译参数后,可以看到我们编译后的class文件是源码的参数名,而非原来的arg0、arg1。 之后我们用原生的反射Parameter.getName() 就可以获取到的方法参数的真实参数名了

注意: 该方式仅对JDK8及以上版本有效, 以前版本JDK没有提供该保留机制

方式2.2: 使用Spring的内部工具类 - ParameterNameDiscoverer

如果正好你的项目依赖了spring,则可以直接使用spring的内部工具类ParameterNameDiscoverer去获取到方法真实参数名。ParameterNameDiscoverer的实现类
主要包含 LocalVariableTableParameterNameDiscoverer、StandardReflectionParameterNameDiscoverer 。 下面介绍如何使用

1、StandardReflectionParameterNameDiscoverer的使用

该发现器需要与 方式2.1: 添加编译参数配置 -parameters 一样添加编译配置, 因为底层也是直接用反射Parameter去获取而已

  // 创建参数名发现器
  ParameterNameDiscoverer discoverer = new StandardReflectionParameterNameDiscoverer();

  Method method = A.class.getMethod(String.class,String.class);

  // 获取方法真实参数名.  userName, userId
  String[] parameterNames = discoverer.getParameterNames(method);

2、LocalVariableTableParameterNameDiscoverer的使用

  // 创建参数名发现器
  ParameterNameDiscoverer discoverer = new LocalVariableTableParameterNameDiscoverer();

  Method method = A.class.getMethod(String.class,String.class);

  // 获取方法真实参数名.  userName, userId
  String[] parameterNames = discoverer.getParameterNames(method);

该发现器底层原理是在编译类时生成一个调试信息的局部变量表LocalVariableTable,然后基于ASM字节码技术去解析LocalVariableTable得到参数名, 所以它也需要在编译时额外添加
编译配置, 请在maven中添加如下-g的编译参数配置

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <compilerArgs>
                        <!-- 生成局部变量表 -->
                        <arg>-g:vars</arg>
                    </compilerArgs>
                </configuration>
            </plugin>
        </plugins>
    </build>

该方法优点是JDK8以下版本也能使用,但是缺点是无法获取到接口的方法参数名

3、DefaultParameterNameDiscoverer的使用

  // 创建参数名发现器
  ParameterNameDiscoverer discoverer = new DefaultParameterNameDiscoverer();

  Method method = A.class.getMethod(String.class,String.class);

  // 获取方法真实参数名.  userName, userId
  String[] parameterNames = discoverer.getParameterNames(method);

这个参数名发现器是一个组合模式的发现器, 本身不去实现获取参数名的逻辑,而是组合其他参数名发现器, 然后迭代调用每个参数名发现器直到找到真实参数名。 从下面源码来看

主要内置了前面讲到的两种StandardReflectionParameterNameDiscoverer 和 LocalVariableTableParameterNameDiscoverer。 所以如果要让对应的参数名发现器生效,需要配合对应发现器的使用逻辑

否则一样无法获取到方法参数名。

// 源码
public class DefaultParameterNameDiscoverer extends PrioritizedParameterNameDiscoverer {

	public DefaultParameterNameDiscoverer() {
		if (!GraalDetector.inImageCode()) {
			if (KotlinDetector.isKotlinReflectPresent()) {
				addDiscoverer(new KotlinReflectionParameterNameDiscoverer());
			}
			addDiscoverer(new StandardReflectionParameterNameDiscoverer()); // 依赖编译参数 -parameters
			addDiscoverer(new LocalVariableTableParameterNameDiscoverer()); //  // 依赖编译参数 -g
		}
	}

}

使用总结

1、参数名获取的本质

  • 所有方案都依赖编译时保留参数名信息(通过-parameters或-g参数), 所以编译的时候有就是有,没有就是没有,尤其是一些第三方依赖的类
  • 如果是第三方依赖的类若未携带调试信息(如未使用上述编译参数进行编译),则无论如何也是无法获取真实参数名, 除非第三方库已使用-parameters编译,仍可通过反射获取(但实际场景较少见)

2、版本适配建议

  • JDK8+项目:
    优先使用-parameters编译参数(性能最佳), 配合StandardReflectionParameterNameDiscoverer
  • JDK7及以下: 使用-g编译参数, 配合LocalVariableTableParameterNameDiscoverer
  • Spring项目: 推荐使用DefaultParameterNameDiscoverer(自动适配最优策略), 可同时配置两种编译参数提升兼容性:

3、在一些springBoot 2.0以后版本中spring-boot-starter-parent会内置了编译参数配置,所以不用配也可以直接使用ParameterNameDiscoverer, 当然需要确保项目是否覆盖了默认配置导致失效,需要重新配

知名应用场景举例

  • spring-mvc 的 @RequestParam 参数名的可省略配置
  • mybatis 的 @Param 也可以不用配置

总结 

到此这篇关于java反射获取方法参数名的几种方式总结的文章就介绍到这了,更多相关java反射获取方法参数名内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Spring测试基本的控制器实战示例

    Spring测试基本的控制器实战示例

    这篇文章主要为大家介绍了Spring测试基本的控制器实战示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-10-10
  • Java 面向对象通过new揭开对象实例化

    Java 面向对象通过new揭开对象实例化

    各位铁汁们大家好呀,我们上次博客讲了,通过 Student student1 = new Student();就可以实例化一个对象,这个对象就有Student类中的所以成员变量。可是 对象student1 和 类Student到底是怎样建立联系的,在内存中到底发生了什么
    2022-04-04
  • Spring Boot定制type Formatters实例详解

    Spring Boot定制type Formatters实例详解

    在本篇文章里小编给大家整理的是关于Spring Boot定制type Formatters实例知识点,需要的朋友们学习下。
    2019-11-11
  • 程序猿必须要掌握的多线程安全问题之锁策略详解

    程序猿必须要掌握的多线程安全问题之锁策略详解

    在笔者面试过程时,经常会被问到各种各样的锁,如乐观锁、读写锁等等,非常繁多,在此做一个总结,介绍的内容如下,需要的朋友可以参考下
    2021-06-06
  • Idea调用WebService的关键步骤和注意事项

    Idea调用WebService的关键步骤和注意事项

    这篇文章主要介绍了如何在Idea中调用WebService,包括理解WebService的基本概念、获取WSDL文件、阅读和理解WSDL文件、选择对接测试工具或方式、发送请求和接收响应、处理响应结果以及错误处理,需要的朋友可以参考下
    2025-01-01
  • Spring获取管理对象常用方法详解

    Spring获取管理对象常用方法详解

    这篇文章主要介绍了Spring获取管理对象常用方法详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-10-10
  • Java ConcurrentHashMap的使用示例

    Java ConcurrentHashMap的使用示例

    这篇文章主要介绍了Java ConcurrentHashMap的使用示例,帮助大家更好的理解和学习使用Java,感兴趣的朋友可以了解下
    2021-04-04
  • 聊聊java变量的初始化之后的默认值

    聊聊java变量的初始化之后的默认值

    这篇文章主要介绍了聊聊java变量的初始化之后的默认值,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-08-08
  • 解决eclipse启动tomcat时不能加载web项目的问题

    解决eclipse启动tomcat时不能加载web项目的问题

    这篇文章主要介绍了解决eclipse启动tomcat时不能加载web项目的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-06-06
  • Idea中指定xml文件失效的解决过程

    Idea中指定xml文件失效的解决过程

    最近在开发的过程中遇到了一个奇怪的问题,下面这篇文章主要给大家介绍了关于Idea中指定xml文件失效的解决过程,文中通过图文介绍的非常详细,需要的朋友可以参考下
    2023-01-01

最新评论