使用 ASM 将参数注解映射到 Class 文件中的对应方法参数-java教程-PHP中文网

使用 ASM 将参数注解映射到 Class 文件中的对应方法参数

花韻仙語

发布： 2025-09-30 18:43:37

原创

296人浏览过

使用 asm 将参数注解映射到 class 文件中的对应方法参数

本文旨在解决在使用 ASM 库处理 Java 字节码时，如何正确地将方法参数的注解信息映射到其对应的参数。由于字节码中的参数索引与源码中的参数顺序可能不一致（例如，存在合成参数时），因此需要特定的策略来建立正确的映射关系。本文将介绍一种基于 Java 反射实现原理的解决方案，并提供相应的示例代码。

在 Java 字节码中，方法参数的注解信息存储在 parameter_annotations 表中。然而，该表中的索引并不一定与方法描述符中的参数顺序完全对应。尤其是在存在合成参数（synthetic parameters）的情况下，例如内部类构造器的隐式 this 参数，索引的偏差就会出现。因此，我们需要一种方法来确定哪个注解对应于哪个参数。

一种方法是模拟 Java 反射框架的处理方式。 Java 反射在处理参数注解时，会假设所有的合成参数都位于参数列表的开头。这种策略对于内部类构造器和枚举类型是有效的，因为 Java 语言规范保证了这些情况下合成参数的位置。

以下是一个使用 ASM 实现此策略的示例：

package asmtest;

import org.objectweb.asm.*;

import java.io.IOException;
import java.lang.annotation.Deprecated;
import java.util.List;

public enum Example {
    ;
    Example(@Deprecated int i) {}
    public class Inner {
        Inner(@Deprecated String foo) {}
    }
}

登录后复制

import org.objectweb.asm.*;

import java.io.IOException;
import java.util.List;

public class ReadParameters extends ClassVisitor {
    public static void main(String[] args) throws IOException {
        for(Class<?> cl: List.of(Example.class, Example.Inner.class)) {
            System.out.println(cl);
            new ClassReader(cl.getName())
                .accept(new ReadParameters(), ClassReader.SKIP_CODE);
            System.out.println();
        }
    }

    @Override
    public MethodVisitor visitMethod(int access, String name, String descriptor,
                                     String signature, String[] exceptions) {
        System.out.println(" " + name);
        return new ParameterVisitor(name, descriptor);
    }

    static class ParameterVisitor extends MethodVisitor {
        final Type[] parameterTypes;
        int offset;

        ParameterVisitor(String name, String desc) {
            super(Opcodes.ASM9);
            parameterTypes = Type.getArgumentTypes(desc);
        }

        @Override
        public void visitAnnotableParameterCount(int parameterCount, boolean visible) {
            offset = parameterTypes.length - parameterCount;
            for(int i = 0; i < offset; i++)
                System.out.printf(" %3d %-20s %s%n",
                    i, parameterTypes[i].getClassName(), "(synthetic)");
        }

        @Override
        public AnnotationVisitor visitParameterAnnotation(
                int parameter, String descriptor, boolean visible) {
            parameter += offset;
            System.out.printf(" %3d %-20s %s%n", parameter,
                parameterTypes[parameter].getClassName(),
                Type.getType(descriptor).getClassName());
            return null;
        }
    }

    protected ReadParameters() {
        super(Opcodes.ASM9);
    }
}

登录后复制

在这个例子中，ReadParameters 类使用 ASM 访问类文件，并打印出每个方法及其参数的注解信息。 ParameterVisitor 类负责处理方法参数。 visitAnnotableParameterCount 方法计算合成参数的数量，并使用 offset 变量来调整注解的索引。 visitParameterAnnotation 方法将调整后的索引用于访问 parameterTypes 数组，从而将注解映射到正确的参数。

怪兽AI数字人

数字人短视频创作，数字人直播，实时驱动数字人

查看详情

输出结果如下：

class asmtest.Example
 values
 valueOf
 <init>
   0 java.lang.String     (synthetic)
   1 int                  (synthetic)
   2 int                  java.lang.Deprecated
 $values
 <clinit>

class asmtest.Example$Inner
 <init>
   0 asmtest.Example      (synthetic)
   1 java.lang.String     java.lang.Deprecated

登录后复制

注意事项：