快捷導(dǎo)航

Java通過反射獲取方法參數(shù)名的方式小結(jié)

更新時間：2025年02月11日 15:32:15 作者：李白的手機(jī)

這篇文章主要為大家詳細(xì)介紹了Java如何通過反射獲取方法參數(shù)名的方式,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下

1、前言

一般當(dāng)我們用類似下面的反射去獲取方法參數(shù)名時得到的一般是 arg0、arg1，參數(shù)名默認(rèn)會丟失, 導(dǎo)致無法獲取到真實(shí)的方法參數(shù)名，下面介紹如何通過其他方式解決。

    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：添加編譯參數(shù)配置 -parameters

java默認(rèn)在編譯工程代碼為class文件時，會將方法參數(shù)名擦除，替換成arg0、arg1之類。但是我們可以在編譯時配置將參數(shù)名也一并編譯進(jìn)去，在maven中新增如下編譯插件配置

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <!-- 配置編譯時將方法參數(shù)名保留 -->
                    <compilerArgs>
                        <arg>-parameters</arg>
                    </compilerArgs>
                </configuration>
            </plugin>

對于較新的 maven 版本(>= 3.6.2), 也可以直接使用 parameters 配置項(xiàng):

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

添加-parameters的編譯參數(shù)后，可以看到我們編譯后的class文件是源碼的參數(shù)名，而非原來的arg0、arg1。之后我們用原生的反射Parameter.getName() 就可以獲取到的方法參數(shù)的真實(shí)參數(shù)名了

注意：該方式僅對JDK8及以上版本有效，以前版本JDK沒有提供該保留機(jī)制

方式2.2：使用Spring的內(nèi)部工具類 - ParameterNameDiscoverer

如果正好你的項(xiàng)目依賴了spring，則可以直接使用spring的內(nèi)部工具類ParameterNameDiscoverer去獲取到方法真實(shí)參數(shù)名。ParameterNameDiscoverer的實(shí)現(xiàn)類主要包含 LocalVariableTableParameterNameDiscoverer、StandardReflectionParameterNameDiscoverer 。下面介紹如何使用

1、StandardReflectionParameterNameDiscoverer的使用

該發(fā)現(xiàn)器需要與方式2.1：添加編譯參數(shù)配置 -parameters 一樣添加編譯配置，因?yàn)榈讓右彩侵苯佑梅瓷銹arameter去獲取而已

  // 創(chuàng)建參數(shù)名發(fā)現(xiàn)器
  ParameterNameDiscoverer discoverer = new StandardReflectionParameterNameDiscoverer();

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

  // 獲取方法真實(shí)參數(shù)名.  userName， userId
  String[] parameterNames = discoverer.getParameterNames(method);

2、LocalVariableTableParameterNameDiscoverer的使用

  // 創(chuàng)建參數(shù)名發(fā)現(xiàn)器
  ParameterNameDiscoverer discoverer = new LocalVariableTableParameterNameDiscoverer();

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

  // 獲取方法真實(shí)參數(shù)名.  userName， userId
  String[] parameterNames = discoverer.getParameterNames(method);

該發(fā)現(xiàn)器底層原理是在編譯類時生成一個調(diào)試信息的局部變量表LocalVariableTable，然后基于ASM字節(jié)碼技術(shù)去解析LocalVariableTable得到參數(shù)名，所以它也需要在編譯時額外添加編譯配置，請在maven中添加如下-g的編譯參數(shù)配置

    <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>

該方法優(yōu)點(diǎn)是JDK8以下版本也能使用，但是缺點(diǎn)是無法獲取到接口的方法參數(shù)名

3、DefaultParameterNameDiscoverer的使用

  // 創(chuàng)建參數(shù)名發(fā)現(xiàn)器
  ParameterNameDiscoverer discoverer = new DefaultParameterNameDiscoverer();

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

  // 獲取方法真實(shí)參數(shù)名.  userName， userId
  String[] parameterNames = discoverer.getParameterNames(method);

這個參數(shù)名發(fā)現(xiàn)器是一個組合模式的發(fā)現(xiàn)器，本身不去實(shí)現(xiàn)獲取參數(shù)名的邏輯，而是組合其他參數(shù)名發(fā)現(xiàn)器，然后迭代調(diào)用每個參數(shù)名發(fā)現(xiàn)器直到找到真實(shí)參數(shù)名。從下面源碼來看主要內(nèi)置了前面講到的兩種StandardReflectionParameterNameDiscoverer 和 LocalVariableTableParameterNameDiscoverer。所以如果要讓對應(yīng)的參數(shù)名發(fā)現(xiàn)器生效，需要配合對應(yīng)發(fā)現(xiàn)器的使用邏輯否則一樣無法獲取到方法參數(shù)名。

// 源碼
public class DefaultParameterNameDiscoverer extends PrioritizedParameterNameDiscoverer {

	public DefaultParameterNameDiscoverer() {
		if (!GraalDetector.inImageCode()) {
			if (KotlinDetector.isKotlinReflectPresent()) {
				addDiscoverer(new KotlinReflectionParameterNameDiscoverer());
			}
			addDiscoverer(new StandardReflectionParameterNameDiscoverer()); // 依賴編譯參數(shù) -parameters
			addDiscoverer(new LocalVariableTableParameterNameDiscoverer()); //  // 依賴編譯參數(shù) -g
		}
	}

}

使用總結(jié)

1、參數(shù)名獲取的本質(zhì)

所有方案都依賴編譯時保留參數(shù)名信息（通過-parameters或-g參數(shù)）, 所以編譯的時候有就是有，沒有就是沒有，尤其是一些第三方依賴的類
如果是第三方依賴的類若未攜帶調(diào)試信息（如未使用上述編譯參數(shù)進(jìn)行編譯），則無論如何也是無法獲取真實(shí)參數(shù)名，除非第三方庫已使用-parameters編譯，仍可通過反射獲取（但實(shí)際場景較少見）

2、版本適配建議

JDK8+項(xiàng)目：優(yōu)先使用-parameters編譯參數(shù)（性能最佳），配合StandardReflectionParameterNameDiscoverer
JDK7及以下：使用-g編譯參數(shù)，配合LocalVariableTableParameterNameDiscoverer
Spring項(xiàng)目：推薦使用DefaultParameterNameDiscoverer（自動適配最優(yōu)策略），可同時配置兩種編譯參數(shù)提升兼容性：

3、在一些springBoot 2.0以后版本中spring-boot-starter-parent會內(nèi)置了編譯參數(shù)配置，所以不用配也可以直接使用ParameterNameDiscoverer，當(dāng)然需要確保項(xiàng)目是否覆蓋了默認(rèn)配置導(dǎo)致失效,需要重新配

知名應(yīng)用場景舉例