ASM Opcodes 完整属性详解

ASM Opcodes 完整属性详解

Opcodes 类概述

Opcodes 类是 ASM 库中的常量定义类，包含了所有 Java 字节码操作码、访问标志、版本号等常量。这些常量用于在字节码级别操作和生成 Java 类。

1. Java 版本常量

使用示例：

// 定义不同版本的类
ClassWriter cw = new ClassWriter(ClassWriter.COMPUTE_FRAMES);

// Java 8 类
cw.visit(Opcodes.V1_8, Opcodes.ACC_PUBLIC, "com/example/Java8Class", null, "java/lang/Object", null);

// Java 11 类  
cw.visit(Opcodes.V11, Opcodes.ACC_PUBLIC, "com/example/Java11Class", null, "java/lang/Object", null);

2. 访问修饰符常量

类访问修饰符

使用示例：

// public final 类
int classAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_FINAL;
cw.visit(Opcodes.V1_8, classAccess, "com/example/FinalClass", null, "java/lang/Object", null);

// 接口定义
int interfaceAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_INTERFACE | Opcodes.ACC_ABSTRACT;
cw.visit(Opcodes.V1_8, interfaceAccess, "com/example/MyInterface", null, "java/lang/Object", null);

// 枚举定义
int enumAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_FINAL | Opcodes.ACC_ENUM;
cw.visit(Opcodes.V1_8, enumAccess, "com/example/MyEnum", null, "java/lang/Enum", null);

字段访问修饰符

使用示例：

// public static final 字段
int fieldAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_STATIC | Opcodes.ACC_FINAL;
cw.visitField(fieldAccess, "CONSTANT", "I", null, 100);

// private volatile 字段
int volatileField = Opcodes.ACC_PRIVATE | Opcodes.ACC_VOLATILE;
cw.visitField(volatileField, "counter", "I", null, null);

方法访问修饰符

使用示例：

// public static 方法
int methodAccess = Opcodes.ACC_PUBLIC | Opcodes.ACC_STATIC;
MethodVisitor mv = cw.visitMethod(methodAccess, "staticMethod", "()V", null, null);

// synchronized 方法  
int syncMethod = Opcodes.ACC_PUBLIC | Opcodes.ACC_SYNCHRONIZED;
MethodVisitor mv2 = cw.visitMethod(syncMethod, "syncMethod", "()V", null, null);

// native 方法
int nativeMethod = Opcodes.ACC_PUBLIC | Opcodes.ACC_NATIVE;
MethodVisitor mv3 = cw.visitMethod(nativeMethod, "nativeMethod", "()V", null, null);

3. 栈操作指令

使用示例：

// 将常量压入栈
mv.visitInsn(Opcodes.ICONST_0);  // 压入 0
mv.visitInsn(Opcodes.ICONST_1);  // 压入 1
mv.visitInsn(Opcodes.ACONST_NULL); // 压入 null

// 创建数组时常用
mv.visitInsn(Opcodes.ICONST_3);  // 压入 3，用于创建长度为3的数组
mv.visitTypeInsn(Opcodes.ANEWARRAY, "java/lang/String");

4. 局部变量加载指令

使用示例：

// 加载局部变量
mv.visitVarInsn(Opcodes.ALOAD, 0);  // 加载 this
mv.visitVarInsn(Opcodes.ILOAD, 1);  // 加载第一个int参数
mv.visitVarInsn(Opcodes.ALOAD, 2);  // 加载第二个引用参数

// 优化指令（索引0-3）
mv.visitVarInsn(Opcodes.ALOAD_0);   // 等同于 aload 0
mv.visitVarInsn(Opcodes.ILOAD_1);   // 等同于 iload 1

5. 局部变量存储指令

使用示例：

// 计算并存储结果
mv.visitVarInsn(Opcodes.ILOAD, 1);
mv.visitVarInsn(Opcodes.ILOAD, 2);
mv.visitInsn(Opcodes.IADD);        // 相加
mv.visitVarInsn(Opcodes.ISTORE, 3); // 存储到局部变量3

// 优化指令
mv.visitVarInsn(Opcodes.ISTORE_1);  // 存储到局部变量1

6. 数组操作指令

使用示例：

// 创建并操作数组
mv.visitInsn(Opcodes.ICONST_3);
mv.visitTypeInsn(Opcodes.ANEWARRAY, "java/lang/String");

// 存储到数组
mv.visitInsn(Opcodes.DUP);          // 复制数组引用
mv.visitInsn(Opcodes.ICONST_0);     // 索引0
mv.visitLdcInsn("Hello");           // 值
mv.visitInsn(Opcodes.AASTORE);      // 存储

// 加载数组元素
mv.visitVarInsn(Opcodes.ALOAD, 1);  // 加载数组引用
mv.visitInsn(Opcodes.ICONST_0);     // 索引0
mv.visitInsn(Opcodes.AALOAD);       // 加载元素

7. 算术运算指令

使用示例：

// 算术运算
mv.visitVarInsn(Opcodes.ILOAD, 1);
mv.visitVarInsn(Opcodes.ILOAD, 2);
mv.visitInsn(Opcodes.IADD);  // a + b

mv.visitVarInsn(Opcodes.ILOAD, 3);
mv.visitInsn(Opcodes.ISUB);  // (a + b) - c

mv.visitVarInsn(Opcodes.ILOAD, 4);
mv.visitInsn(Opcodes.IMUL);  // ((a + b) - c) * d

8. 类型转换指令

使用示例：

// 类型转换
mv.visitVarInsn(Opcodes.ILOAD, 1);  // 加载 int
mv.visitInsn(Opcodes.I2L);         // 转换为 long
mv.visitVarInsn(Opcodes.ILOAD, 2);  // 加载另一个 int
mv.visitInsn(Opcodes.I2L);         // 转换为 long
mv.visitInsn(Opcodes.LADD);        // long 加法

// 截断转换
mv.visitVarInsn(Opcodes.DLOAD, 1);  // 加载 double
mv.visitInsn(Opcodes.D2I);         // 转换为 int（截断）

9. 对象操作指令

使用示例：

// 创建对象
mv.visitTypeInsn(Opcodes.NEW, "java/util/Date");
mv.visitInsn(Opcodes.DUP);
mv.visitMethodInsn(Opcodes.INVOKESPECIAL, "java/util/Date", "<init>", "()V", false);

// 字段操作
mv.visitFieldInsn(Opcodes.GETSTATIC, "java/lang/System", "out", "Ljava/io/PrintStream;");
mv.visitVarInsn(Opcodes.ALOAD, 0);
mv.visitFieldInsn(Opcodes.GETFIELD, "com/example/MyClass", "name", "Ljava/lang/String;");

// 类型检查
mv.visitTypeInsn(Opcodes.CHECKCAST, "java/lang/String");
mv.visitTypeInsn(Opcodes.INSTANCEOF, "java/util/List");

10. 方法调用指令

使用示例：

// 调用实例方法
mv.visitMethodInsn(Opcodes.INVOKEVIRTUAL, "java/io/PrintStream", "println", "(Ljava/lang/String;)V", false);

// 调用构造函数
mv.visitMethodInsn(Opcodes.INVOKESPECIAL, "java/lang/Object", "<init>", "()V", false);

// 调用静态方法
mv.visitMethodInsn(Opcodes.INVOKESTATIC, "java/lang/Math", "max", "(II)I", false);

// 调用接口方法
mv.visitMethodInsn(Opcodes.INVOKEINTERFACE, "java/util/List", "size", "()I", true);

11. 控制转移指令

使用示例：

Label start = new Label();
Label end = new Label();
Label ifTrue = new Label();

mv.visitLabel(start);
mv.visitVarInsn(Opcodes.ILOAD, 1);
mv.visitJumpInsn(Opcodes.IFNE, ifTrue);  // 如果不等于0跳转

// false 分支代码
mv.visitInsn(Opcodes.ICONST_0);
mv.visitJumpInsn(Opcodes.GOTO, end);

// true 分支代码
mv.visitLabel(ifTrue);
mv.visitInsn(Opcodes.ICONST_1);

// 结束标签
mv.visitLabel(end);

12. 返回指令

使用示例：

// 根据不同返回类型使用不同指令
Type returnType = Type.getReturnType(methodDesc);
switch (returnType.getSort()) {
    case Type.VOID:
        mv.visitInsn(Opcodes.RETURN);
        break;
    case Type.INT:
        mv.visitInsn(Opcodes.IRETURN);
        break;
    case Type.OBJECT:
        mv.visitInsn(Opcodes.ARETURN);
        break;
    // ... 其他类型
}

13. ASM 特定常量

使用示例：

// 使用特定版本的 ASM API
ClassVisitor cv = new ClassVisitor(Opcodes.ASM7) {
    // 类访问逻辑
};

MethodVisitor mv = new MethodVisitor(Opcodes.ASM7) {
    // 方法访问逻辑
};

14. 其他重要常量